com:Class (in SurrogateServer)

Definisce una registrazione della classe SurrogateServer.

Gerarchia elementi

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

Sintassi

<com:Class
  Path = 'A required string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ThreadingModel = 'A required string that can have one of the following values: "Both", "STA", "MTA", "MainSTA", or "Neutral".'
  EnableOleDefaultHandler = 'An optional boolean value.'
  ProgId = 'An optional alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1'
  VersionIndependentProgId = 'An optional alphanumeric string separated by a period between 1 and 255 characters in length, e.g. 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 between 1 and 40 characters in length.'
  Id = 'A required GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
  DisplayName = 'An optional string between 1 and 256 characters in length. This string is localizable.' >

  <!-- Child elements -->
  com:ImplementedCategories?
  com:Conversion?
  com:DataFormats?
  com:MiscStatus?
  com:Verbs?
  com:DefaultIcon?
  com:ToolboxBitmap32?

</com:Class>

chiave

? facoltativo (zero o uno)

Attributes

Attribute Descrizione Tipo di dati Obbligatorio Valore predefinito
Percorso Percorso completo della DLL della classe surrogata. Stringa compresa tra 1 e 256 caratteri che non può contenere questi caratteri: <, , >:, ", |, ?o *.
Threadingmodel Modello di threading per il caricamento di DLL. Stringa che può avere uno dei valori seguenti: Both, STA, MTA, MainSTA, Neutral.
EnableOleDefaultHandler Deve essere impostato su true se il valore predefinito della chiave InprocHandler32 è "Ole32.dll". In caso contrario, deve essere omesso. Il valore predefinito è false. Valore booleano facoltativo. NO
Progid Associa un identificatore programmatico (ProgID) a un CLSID. Stringa alfanumerica facoltativa separata da un punto compreso tra 1 e 255 caratteri, ad esempio Foo.Bar o Foo.Bar.1 NO
VersionIndependentProgId Associa un ProgID a un CLSID. Questo valore viene usato per determinare la versione più recente di un'applicazione oggetto. Stringa alfanumerica facoltativa separata da un punto compreso tra 1 e 255 caratteri, ad esempio Foo.Bar o Foo.Bar.1 NO
AutoConvertTo Specifica la conversione automatica di una determinata classe di oggetti in una nuova classe di oggetti. GUID facoltativo nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. NO
InsertableObject Indica che questa classe può essere inserita. Valore booleano facoltativo. NO
ShortDisplayName Versione breve del nome visualizzato della classe. Stringa facoltativa compresa tra 1 e 40 caratteri. NO
ID L'attributo Id corrisponde al CLSID. GUID nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
DisplayName Stringa localizzabile corrispondente al valore predefinito della chiave CLSID. Stringa facoltativa compresa tra 1 e 256 caratteri. Questa stringa è localizzabile. NO

Elementi figli

Elemento figlio Descrizione
com:ImplementedCategories Specifica le categorie implementate dalla classe .
com:Conversion Specifica i formati che un'applicazione può leggere e scrivere.
com:DataFormats Specifica i formati di dati predefiniti e principali supportati da un'applicazione.
com:MiscStatus Specifica come creare e visualizzare un oggetto .
com:Verbs Specifica i verbi da registrare per un'applicazione.
com:DefaultIcon Fornisce informazioni sull'icona predefinite per le presentazioni iconiche degli oggetti.
com:ToolboxBitmap32 Identifica il nome del modulo e l'ID risorsa per una bitmap 16 x 16 da usare per il viso di una barra degli strumenti o di un pulsante della casella degli strumenti.

Elementi principali

Elemento padre Descrizione
com:SurrogateServer Registra un SurrogateServer con una o più registrazioni di classe.

Requisiti

Elemento Valore
spazio dei nomi http://schemas.microsoft.com/appx/manifest/com/windows10
versione minima del sistema operativo Windows 10 versione 1703 (Build 15063)

Osservazioni:

Le registrazioni di classe con lo stesso AppId devono condividere un SurrogateServer, a meno che non debbano essere registrate in elementi diversi Applications/Application manifesto.

ThreadingModel corrisponde al modello di threading InprocServer32. Le registrazioni della classe SurrogateServer devono avere una registrazione InprocServer32 nell'hive privato del pacchetto.

Examples