WorkbookExtensions.GetVstoObject Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| GetVstoObject(_Workbook, ApplicationFactory) |
Restituisce un elemento host Workbook che estende le funzionalità dell'oggetto Workbook corrente in un componente aggiuntivo a livello di applicazione. Passare l'oggetto Globals.Factory nel progetto al parametro |
| GetVstoObject(_Workbook, Factory) |
Restituisce un elemento host Workbook che estende le funzionalità dell'oggetto Workbook corrente in una personalizzazione a livello di documento. Passare l'oggetto Globals.Factory nel progetto al parametro |
GetVstoObject(_Workbook, ApplicationFactory)
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Office::Tools::Excel::Workbook ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Workbook ^ workbook, Microsoft::Office::Tools::Excel::ApplicationFactory ^ factory);
public static Microsoft.Office.Tools.Excel.Workbook GetVstoObject(this Microsoft.Office.Interop.Excel._Workbook workbook, Microsoft.Office.Tools.Excel.ApplicationFactory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Workbook * Microsoft.Office.Tools.Excel.ApplicationFactory -> Microsoft.Office.Tools.Excel.Workbook
<Extension()>
Public Function GetVstoObject (workbook As _Workbook, factory As ApplicationFactory) As Workbook
Parametri
- workbook
- _Workbook
L'oggetto foglio di lavoro nativo da estendere. Non indicare questo parametro autonomamente. Quando si chiama questo metodo per un foglio di lavoro di Excel, il runtime specifica questo parametro.
- factory
- ApplicationFactory
Oggetto che consente di accedere a determinate funzionalità nel componente aggiuntivo a livello di applicazione. Passare l'oggetto Globals.Factory a questo parametro.
Restituisce
Elemento host che estende le funzionalità dell'oggetto Workbook corrente.
Commenti
In un componente aggiuntivo a livello di applicazione, chiamare questo metodo per estendere qualsiasi cartella di lavoro aperta in Excel. Questo metodo genera un nuovo Microsoft.Office.Tools.Excel.Workbook elemento host se tale oggetto non è già stato generato per l' Microsoft.Office.Interop.Excel.Workbook oggetto su cui viene chiamato questo metodo. Le chiamate successive a questo metodo sullo stesso Microsoft.Office.Interop.Excel.Workbook oggetto restituiscono la stessa Microsoft.Office.Tools.Excel.Workbook istanza.
Questo metodo viene fornito per la compatibilità con le versioni precedenti con i progetti di Office che si retargetno da .NET Framework 3.5 a .NET Framework 4 o .NET Framework 4.5. Nei nuovi progetti destinati a .NET Framework 4 o .NET Framework 4.5 è necessario chiamare il GetVstoObject metodo fornito dall'oggetto Globals.Factory nel progetto.
Per altre informazioni, vedere Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.
Nota
Il workbook parametro è di tipo Microsoft.Office.Interop.Excel._Workbook , che è l'interfaccia padre di Microsoft.Office.Interop.Excel.Workbook . Questo metodo estende pertanto entrambi i tipi: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook . In genere, quando si fa riferimento a una cartella di lavoro di Excel, si utilizza un Microsoft.Office.Interop.Excel.Workbook .
Si applica a
GetVstoObject(_Workbook, Factory)
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Office::Tools::Excel::Workbook ^ GetVstoObject(Microsoft::Office::Interop::Excel::_Workbook ^ workbook, Microsoft::Office::Tools::Excel::Factory ^ factory);
public static Microsoft.Office.Tools.Excel.Workbook GetVstoObject(this Microsoft.Office.Interop.Excel._Workbook workbook, Microsoft.Office.Tools.Excel.Factory factory);
static member GetVstoObject : Microsoft.Office.Interop.Excel._Workbook * Microsoft.Office.Tools.Excel.Factory -> Microsoft.Office.Tools.Excel.Workbook
<Extension()>
Public Function GetVstoObject (workbook As _Workbook, factory As Factory) As Workbook
Parametri
- workbook
- _Workbook
L'oggetto foglio di lavoro nativo da estendere. Non indicare questo parametro autonomamente. Quando si chiama questo metodo per un foglio di lavoro di Excel, il runtime specifica questo parametro.
- factory
- Factory
Oggetto che consente di accedere a determinate funzionalità nella personalizzazione a livello di documento. Passare l'oggetto Globals.Factory a questo parametro.
Restituisce
Elemento host che estende le funzionalità dell'oggetto Workbook corrente.
Commenti
In una personalizzazione a livello di documento, è possibile chiamare questo metodo per ottenere un Microsoft.Office.Tools.Excel.Workbook elemento host nella personalizzazione corrente. Se l' Microsoft.Office.Interop.Excel.Workbook oggetto su cui viene chiamato questo metodo non è l'oggetto sottostante di un Microsoft.Office.Tools.Excel.Workbook elemento host nella personalizzazione corrente, questo metodo restituisce null .
Questo metodo viene fornito per la compatibilità con le versioni precedenti con i progetti di Office che si retargetno da .NET Framework 3.5 a .NET Framework 4 o .NET Framework 4.5. Nei nuovi progetti destinati a .NET Framework 4 o .NET Framework 4.5 è necessario chiamare il GetVstoObject metodo fornito dall'oggetto Globals.Factory nel progetto. Per altre informazioni, vedere Programming Document-Level Customizations.
Nota
Il workbook parametro è di tipo Microsoft.Office.Interop.Excel._Workbook , che è l'interfaccia padre di Microsoft.Office.Interop.Excel.Workbook . Questo metodo estende pertanto entrambi i tipi: Microsoft.Office.Interop.Excel._Workbook e Microsoft.Office.Interop.Excel.Workbook . In genere, quando si fa riferimento a una cartella di lavoro di Excel, si utilizza un Microsoft.Office.Interop.Excel.Workbook .