com:Class (в SurrogateServer/Class)

Определяет регистрацию класса SurrogateServer.

Иерархия элементов

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <com:Extension>
               └─ <com:ComServer>
                  └─ <com:SurrogateServer>
                     └─ <com:Class>

Синтаксис

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    VersionIndependentProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    AutoConvertTo = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'An optional boolean value.'
    ShortDisplayName = 'An optional string with a value between 1 and 40 characters in length.' >

  <!-- Child elements -->
  ( ImplementedCategories,
  Conversion?,
  DataFormats?,
  MiscStatus?,
  Verbs?,
  DefaultIcon?,
  ToolboxBitmap32? 
  )

</com:Class>

Ключ

? необязательный (ноль или один)

Элементы и атрибуты

Атрибуты

Атрибут Описание Тип данных Обязательный Значение по умолчанию
Id Атрибут Id соответствует CLSID. GUID в форме xxxx-xxxx-xxxx-xxxx-xxxx. Да
Путь Полный путь к библиотеке DLL суррогатного класса. Строка со значением от 1 до 256 символов длиной, которая не может содержать следующие символы: <, >, :, ", |, ?или *. Да
ThreadingModel Модель потоков для загрузки библиотек DLL. Строка, которая может быть одним из следующих значений : КАК, STA, MTA, MainSTA, Neutral. Да
DisplayName Локализованная строка, соответствующая значению ключа CLSID по умолчанию. Необязательная строка со значением от 1 до 256 символов длиной. Нет
EnableOleDefaultHandler Это значение должно иметь значение true, если значение по умолчанию ключа InprocHandler32 имеет значение "Ole32.dll". В противном случае он должен быть опущен. По умолчанию используется значение false. Необязательное логическое значение. Нет
Progid Связывает программный идентификатор (ProgID) с CLSID. Необязательная буквенно-цифровые строки, разделенные точкой со значением от 1 до 255 символов длиной (например, Foo.Bar или Foo.Bar.1) Нет
VersionIndependentProgId Связывает ProgID с CLSID. Это значение используется для определения последней версии приложения объекта. Необязательная буквенно-цифровые строки, разделенные точкой со значением от 1 до 255 символов длиной (например, Foo.Bar или Foo.Bar.1) Нет
AutoConvertTo Задает автоматическое преобразование заданного класса объектов в новый класс объектов. Необязательный GUID в форме xxxx-xxxx-xxxx-xxxx-xxxx-xxxx. Нет
InsertableObject Указывает, что этот класс можно вставить. Необязательное логическое значение. Нет
ShortDisplayName Краткая версия отображаемого имени класса. Необязательная строка со значением от 1 до 40 символов в длину. Нет

Дочерние элементы

Дочерний элемент Описание
Реализованные категории Задает категории, реализованные классом.
Преобразование Указывает разрешения на чтение и запись класса.
Dataformats Задает поддерживаемые по умолчанию и основные форматы данных.
MiscStatus Указывает, как создать и отобразить объект.
Глаголы Указывает команды, которые необходимо зарегистрировать для приложения.
DefaultIcon Предоставляет сведения о значке по умолчанию для знаковых презентаций объектов.
Панель элементовBitmap32 Определяет имя модуля и идентификатор ресурса для растрового изображения 16 x 16, используемого для лица панели инструментов или кнопки панели элементов.

Родительские элементы

Родительский элемент Описание
com:SurrogateServer Регистрирует суррогатный сервер с одной или несколькими регистрациями классов.

Замечания

Регистрация классов с тем же Идентификатором AppId должна совместно использовать SurrogateServer, если только они не должны быть зарегистрированы в разных Applicationsэлементах /Application манифеста.

ThreadingModel соответствует модели потоков InprocServer32. Регистрация класса SurrogateServer должна иметь регистрацию InprocServer32 в частном кусте пакета.

Требования

Элемент Ценность
Пространство имен http://schemas.microsoft.com/appx/manifest/com/windows10
минимальная версия ОС Windows 10 версии 1703 (сборка 15063)