Creazione guidata componente ATL COM+ 1.0

Aggiornamento: novembre 2007

È possibile utilizzare questa procedura guidata per aggiungere al progetto un oggetto che supporta i servizi COM+ 1.0, incluse le transazioni.

È possibile specificare se l'oggetto supporta le interfacce duali e l'automazione. È inoltre possibile definire il supporto per l'interfaccia di informazioni sugli errori, il controllo di oggetti avanzato, le transazioni e l'accodamento asincrono dei messaggi.

Osservazioni

A partire da Visual Studio 2008, lo script della registrazione prodotto da questa procedura guidata registrerà i componenti COM in HKEY_CURRENT_USER invece di HKEY_LOCAL_MACHINE. Per modificare questo comportamento, impostare l'opzione Registra componente per tutti gli utenti della procedura guidata ATL.

Nomi

È possibile specificare il nome dell'oggetto, dell'interfaccia e delle classi da aggiungere al progetto. Ad eccezione di Nome breve, il testo di tutte le altre caselle può essere modificato in modo indipendente. Se si cambia il testo in Nome breve, la modifica avrà effetto sui nomi specificati in tutte le altre caselle di questa schermata. Se si cambia il nome specificato in Coclasse nella sezione COM, le modifiche si rifletteranno sui nomi presenti nelle caselle Tipo e ProgID, mentre il nome specificato inInterfaccia non verrà modificato. Grazie a questo comportamento di denominazione, tutti i nomi sono facilmente identificabili nel corso dello sviluppo del controllo.

• Nome breve
  Consente di impostare il nome abbreviato per l'oggetto. Attraverso questo nome vengono definiti i nomi specificati nelle caselle Class e Coclass, .cpp file e .h file, InterfacciaTipo e ProgID, a meno che tali campi non vengano modificati singolarmente.

• File H
  Consente di impostare il nome del file di intestazione per la classe del nuovo oggetto. Per impostazione predefinita, il nome si basa su quello specificato in Nome breve. Fare clic sul pulsante con i puntini di sospensione per salvare il nome file nella posizione desiderata o per aggiungere la dichiarazione di classe a un file esistente. Se si sceglie un file esistente, questo non verrà salvato nella posizione selezionata finché non si sceglie Fine all'interno della procedura guidata.

  Il file non viene sovrascritto. Se si seleziona il nome di un file esistente, quando si sceglie Fine nella procedura guidata viene chiesto di indicare se aggiungere la dichiarazione di classe al contenuto del file. Scegliere Sì per aggiungere il file oppure No per tornare alla procedura guidata e specificare un altro nome file.

• Classe
  Consente di impostare il nome della classe da creare. Tale nome è basato sul nome specificato in Nome breve, preceduto da "C", il prefisso standard per un nome di classe.

• File CPP
  Consente di impostare il nome del file di implementazione per la classe del nuovo oggetto. Per impostazione predefinita, questo nome si basa su quello specificato in Nome breve. Fare clic sul pulsante con i puntini di sospensione per salvare il nome file nella posizione desiderata. Il file non verrà salvato nella posizione selezionata finché non si sceglie Fine all'interno della procedura guidata.

  Il file non viene sovrascritto. Se si seleziona il nome di un file esistente, quando si sceglie Fine nella procedura guidata viene chiesto di indicare se aggiungere l'implementazione della classe al termine del contenuto del file. Scegliere Sì per aggiungere il file oppure No per tornare alla procedura guidata e specificare un altro nome file.

• Con attributi
  Consente di specificare se l'oggetto utilizza gli attributi. Se si aggiunge un oggetto a un progetto ATL con attributi, questa opzione è selezionata e non può essere modificata. A un progetto creato con supporto degli attributi è quindi possibile aggiungere solo oggetti con attributi.

  Se si seleziona questa opzione per un progetto ATL senza supporto degli attributi, verrà chiesto di specificare se aggiungere tale supporto al progetto.

  Per impostazione predefinita, qualsiasi oggetto aggiunto successivamente alla selezione di questa opzione viene designato come oggetto con attributi (casella di controllo selezionata). È possibile deselezionare questa casella per aggiungere un oggetto che non utilizza gli attributi.

  Per ulteriori informazioni, vedere Impostazioni applicazione, Creazione guidata progetto ATL e Meccanismi fondamentali degli attributi.

COM

È possibile specificare informazioni sulle funzionalità COM per l'oggetto.

• Coclasse
  Consente di impostare il nome della classe Component che contiene un elenco di interfacce supportate dall'oggetto.

  Nota:
  Se si crea il progetto utilizzando gli attributi o se si indica in questa schermata della procedura guidata che il componente COM+ 1.0 utilizza gli attributi, non è possibile modificare questa opzione poiché ATL non include l'attributo coclass.

• Tipo
  Consente di impostare la descrizione dell'oggetto che verrà visualizzata nel Registro di sistema.

• Interfaccia
  Consente di impostare l'interfaccia creata per l'oggetto, la quale contiene i metodi personalizzati.

• ProgID
  Consente di impostare il nome che può essere utilizzato dai contenitori al posto del CLSID dell'oggetto.

Vedere anche

Attività

Aggiunta di un componente ATL COM+ 1.0