AddInToken.Activate Yöntem

Başvuru

Tanım

Ad Alanı:: System.AddIn.Hosting

Bütünleştirilmiş Kod:: System.AddIn.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Eklentiyi etkinleştirir.

Aşırı Yüklemeler

Activate<T>(AddInEnvironment)	Bir eklentiyi başka bir eklentinin ortamında etkinleştirir.
Activate<T>(AddInSecurityLevel)	Yeni bir uygulama etki alanında belirtilen güven düzeyine sahip bir eklentiyi etkinleştirir.
Activate<T>(AppDomain)	Mevcut uygulama etki alanındaki bir eklentiyi etkinleştirir.
Activate<T>(PermissionSet)	Yeni uygulama etki alanında belirtilen izin kümesine sahip bir eklentiyi etkinleştirir.
Activate<T>(AddInProcess, AddInSecurityLevel)	Bir dış işlemde, yeni bir uygulama etki alanında ve belirtilen güven düzeyine sahip bir eklentiyi etkinleştirir.
Activate<T>(AddInProcess, PermissionSet)	Bir dış işlemdeki, yeni bir uygulama etki alanındaki ve belirtilen izin kümesine sahip bir eklentiyi etkinleştirir.
Activate<T>(AddInSecurityLevel, String)	Belirtilen ad ve güven düzeyine sahip yeni bir uygulama etki alanındaki bir eklentiyi etkinleştirir.

Activate<T>(AddInEnvironment)

Bir eklentiyi başka bir eklentinin ortamında etkinleştirir.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInEnvironment ^ environment);

public T Activate<T> (System.AddIn.Hosting.AddInEnvironment environment);

member this.Activate : System.AddIn.Hosting.AddInEnvironment -> 'T

Public Function Activate(Of T) (environment As AddInEnvironment) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

environment: AddInEnvironment

Özgün eklentiyi içeren uygulama etki alanı ve işlemi.

Döndürülenler

Eklentinin konak görünümü.

Örnekler

Aşağıdaki örnek, otomatik olarak oluşturulan bir uygulama etki alanında belirtilen güvenlik düzeyine sahip bir eklentiyi etkinleştirir. Ardından aynı uygulama etki alanında ikinci bir eklentiyi etkinleştirir ve ilk eklentinin nesnesini kullanarak ilk eklenti AddInEnvironment olarak işler.

// Get the AddInController of a
// currently actived add-in (CalcAddIn).
AddInController aiController = AddInController.GetAddInController(CalcAddIn);

// Select another token.
AddInToken selectedToken2 = ChooseAddIn(tokens);

// Activate a second add-in, CalcAddIn2, in the same
// appliation domain and process as the first add-in by passing
// the first add-in's AddInEnvironment object to the Activate method.
AddInEnvironment aiEnvironment = aiController.AddInEnvironment;
Calculator CalcAddIn2 =
    selectedToken2.Activate<Calculator>(aiEnvironment);

// Get the AddInController for the second add-in to compare environments.
AddInController aiController2 = AddInController.GetAddInController(CalcAddIn2);
Console.WriteLine("Add-ins in same application domain: {0}", aiController.AppDomain.Equals(aiController2.AppDomain));
Console.WriteLine("Add-ins in same process: {0}", aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process));

' Get the AddInController of a 
' currently activated add-in (CalcAddIn).
Dim aiController As AddInController = AddInController.GetAddInController(CalcAddIn)

' Select another token.
Dim selectedToken2 As AddInToken = ChooseAddIn(tokens)

' Activate a second add-in, CalcAddIn2, in the same
' appliation domain and process as the first add-in by passing
' the first add-in's AddInEnvironment object to the Activate method.

Dim aiEnvironment As AddInEnvironment = aiController.AddInEnvironment
Dim CalcAddIn2 As Calculator = _
    selectedToken2.Activate(Of Calculator)(aiEnvironment)

' Get the AddInController for the second add-in to compare environments.
Dim aiController2 As AddInController = AddInController.GetAddInController(CalcAddIn2)

Console.WriteLine("Add-ins in same application domain: {0}", _
    aiController.AppDomain.Equals(aiController2.AppDomain))
Console.WriteLine("Add-ins in same process: {0}", _
    aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process))

Açıklamalar

Bu yöntem aşırı yüklemesi, eklentiyi edinilen eklentiyle aynı uygulama etki alanında ve işlemde environment etkinleştirir.

Ayrıca bkz.

Eklentiler ve Genişletilebilirlik

Şunlara uygulanır

Activate<T>(AddInSecurityLevel)

Yeni bir uygulama etki alanında belirtilen güven düzeyine sahip bir eklentiyi etkinleştirir.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInSecurityLevel trustLevel);

public T Activate<T> (System.AddIn.Hosting.AddInSecurityLevel trustLevel);

member this.Activate : System.AddIn.Hosting.AddInSecurityLevel -> 'T

Public Function Activate(Of T) (trustLevel As AddInSecurityLevel) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

trustLevel: AddInSecurityLevel

Güven düzeyini belirten numaralandırma değerlerinden biri.

Döndürülenler

Eklentinin konak görünümü.

Örnekler

Aşağıdaki örnek, belirtilen güvenlik düzeyine sahip otomatik olarak oluşturulan bir uygulama etki alanında seçilen belirteç tarafından tanımlanan bir eklentinin nasıl etkinleştirildiğini gösterir.

//Ask the user which add-in they would like to use.
AddInToken selectedToken = ChooseAddIn(tokens);

//Activate the selected AddInToken in a new
//application domain with the Internet trust level.
Calculator CalcAddIn = selectedToken.Activate<Calculator>(AddInSecurityLevel.Internet);

//Run the add-in using a custom method.
RunCalculator(CalcAddIn);

'Ask the user which add-in they would like to use.
Dim selectedToken As AddInToken = ChooseAddIn(tokens)
'Activate the selected AddInToken in a new
'application domain with the Internet trust level.
Dim CalcAddIn As Calculator = selectedToken.Activate(Of Calculator)(AddInSecurityLevel.Internet)
'Run the add-in using a custom method.
RunCalculator(CalcAddIn)

Açıklamalar

Bu yöntem eklentiyi otomatik olarak oluşturulan bir uygulama etki alanına yükler. Yeni uygulama etki alanı için bir ad belirtmek istiyorsanız aşırı yüklemeyi kullanın Activate<T>(AddInSecurityLevel, String) .

Bu yöntem, uygulama etki alanının temel dizinini eklenti derlemesinin konumu olarak ayarlar. Ayrıca [addinassemblyname].dll.config yapılandırma dosyasını arar ve bulunursa, yeni uygulama etki alanının yapılandırma dosyası olarak ayarlar.

Ayrıca bkz.

Eklentiler ve Genişletilebilirlik

Şunlara uygulanır

Activate<T>(AppDomain)

Mevcut uygulama etki alanındaki bir eklentiyi etkinleştirir.

public:
generic <typename T>
 T Activate(AppDomain ^ target);

public T Activate<T> (AppDomain target);

member this.Activate : AppDomain -> 'T

Public Function Activate(Of T) (target As AppDomain) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

target: AppDomain

Eklentinin etkinleştirileceği uygulama etki alanı.

Döndürülenler

Eklentinin konak görünümü.

Özel durumlar

SecurityException

Tam güven izni talep edilir. Çağrı zincirindeki bir çağıranın yeterli izni yok.

Örnekler

Aşağıdaki örnek, başka bir eklenti tarafından kullanılan bir uygulama etki alanındaki eklentiyi etkinleştirir. İlk eklentinin kodu sınıfında AddInToken sağlanır.

// Get the application domain
// of an existing add-in (CalcAddIn).
AddInController aiCtrl = AddInController.GetAddInController(CalcAddIn);
AppDomain AddInAppDom = aiCtrl.AppDomain;

// Activate another add-in in the same application domain.
Calculator CalcAddIn3 =
    selectedToken2.Activate<Calculator>(AddInAppDom);

// Show that CalcAddIn3 was loaded
// into CalcAddIn's application domain.
AddInController aic = AddInController.GetAddInController(CalcAddIn3);
Console.WriteLine("Add-in loaded into existing application domain: {0}",
    aic.AppDomain.Equals(AddInAppDom));

' Get the application domain
' of an existing add-in (CalcAddIn).

Dim aiCtrl As AddInController = AddInController.GetAddInController(CalcAddIn)
Dim AddInAppDom As AppDomain = aiCtrl.AppDomain

' Activate another add-in in the same appliation domain.
Dim CalcAddIn3 As Calculator = selectedToken2.Activate(Of Calculator)(AddInAppDom)

' Show that the CalcAddIn3 was loaded
' into CalcCaddIn's application domain.
Dim aic As AddInController = AddInController.GetAddInController(CalcAddIn3)
Console.WriteLine("Add-in loaded into existing application domain: {0}", _
 aic.AppDomain.Equals(AddInAppDom))

Açıklamalar

Otomatik olarak oluşturulan bir uygulama etki alanındaki bir eklentiyi etkinleştirmek için, belirtilen güvenlik düzeyine sahip yeni bir uygulama etki alanı oluşturmak için aşırı yüklemeyi veya Activate<T>(AddInSecurityLevel, String) uygulama etki alanı için kolay bir ad eklemek üzere aşırı yüklemeyi kullanınActivate<T>(AddInSecurityLevel).

Şunlara uygulanır

Activate<T>(PermissionSet)

Yeni uygulama etki alanında belirtilen izin kümesine sahip bir eklentiyi etkinleştirir.

public:
generic <typename T>
 T Activate(System::Security::PermissionSet ^ permissions);

public T Activate<T> (System.Security.PermissionSet permissions);

member this.Activate : System.Security.PermissionSet -> 'T

Public Function Activate(Of T) (permissions As PermissionSet) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

permissions: PermissionSet

Eklenti için verilen izinler.

Döndürülenler

Eklentinin konak görünümü.

Özel durumlar

ArgumentNullException

permissions, null değeridir.

Açıklamalar

Bu yöntem eklentiyi otomatik olarak oluşturulan bir uygulama etki alanına yükler. Uygulama etki alanının temel dizinini eklenti derlemesinin konumu olarak ayarlar. Ayrıca yapılandırma dosyasını [addinassemblyname].dll.config arar ve bulunursa yeni uygulama etki alanı için yapılandırma dosyası olarak ayarlar.

Şunlara uygulanır

Activate<T>(AddInProcess, AddInSecurityLevel)

Bir dış işlemde, yeni bir uygulama etki alanında ve belirtilen güven düzeyine sahip bir eklentiyi etkinleştirir.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInProcess ^ process, System::AddIn::Hosting::AddInSecurityLevel level);

public T Activate<T> (System.AddIn.Hosting.AddInProcess process, System.AddIn.Hosting.AddInSecurityLevel level);

member this.Activate : System.AddIn.Hosting.AddInProcess * System.AddIn.Hosting.AddInSecurityLevel -> 'T

Public Function Activate(Of T) (process As AddInProcess, level As AddInSecurityLevel) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

process: AddInProcess

Eklentinin etkinleştirildiği dış işlem.

level: AddInSecurityLevel

Güven düzeyini belirten numaralandırma değerlerinden biri.

Döndürülenler

Eklentinin konak görünümü.

Örnekler

Aşağıdaki örnek yeni bir işlem oluşturur ve bu işlemdeki bir eklentiyi tam güven güvenlik düzeyiyle etkinleştirir.

// Create an external process.
AddInProcess pExternal = new AddInProcess();

// Activate an add-in in the external process
// with a full trust security level.
Calculator CalcAddIn4 =
    selectedToken.Activate<Calculator>(pExternal,
    AddInSecurityLevel.FullTrust);

// Show that the add-in is an external process
// by verifying that it is not in the current (host's) process.
AddInController AddinCtl = AddInController.GetAddInController(CalcAddIn4);
Console.WriteLine("Add-in in host's process: {0}",
    AddinCtl.AddInEnvironment.Process.IsCurrentProcess);

' Create an external process.
Dim pExternal As New AddInProcess()

' Activate an add-in in the external process
' with a full trust security level.
Dim CalcAddIn4 As Calculator = _
    selectedToken.Activate(Of Calculator)(pExternal, _
        AddInSecurityLevel.FullTrust)

' Show that the add-in is an external process
' by verifying that it is not in the current (host's) process.
Dim AddinCtl As AddInController = AddInController.GetAddInController(CalcAddIn4)
Console.WriteLine("Add-in in host's process: {0}", _
 AddinCtl.AddInEnvironment.Process.IsCurrentProcess)

Açıklamalar

Bu yöntem, uygulama etki alanının temel dizinini eklenti derlemesinin konumu olarak ayarlar. Ayrıca yapılandırma dosyasını [addinassemblyname].dll.config arar ve bulunursa yeni uygulama etki alanı için yapılandırma dosyası olarak ayarlar.

Şunlara uygulanır

Activate<T>(AddInProcess, PermissionSet)

Bir dış işlemdeki, yeni bir uygulama etki alanındaki ve belirtilen izin kümesine sahip bir eklentiyi etkinleştirir.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInProcess ^ process, System::Security::PermissionSet ^ permissionSet);

public T Activate<T> (System.AddIn.Hosting.AddInProcess process, System.Security.PermissionSet permissionSet);

member this.Activate : System.AddIn.Hosting.AddInProcess * System.Security.PermissionSet -> 'T

Public Function Activate(Of T) (process As AddInProcess, permissionSet As PermissionSet) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

process: AddInProcess

Eklentinin etkinleştirildiği dış işlem.

permissionSet: PermissionSet

Eklenti için verilen gerekli izin kümesi.

Döndürülenler

Eklentinin konak görünümü.

Açıklamalar

Şunlara uygulanır

Activate<T>(AddInSecurityLevel, String)

Belirtilen ad ve güven düzeyine sahip yeni bir uygulama etki alanındaki bir eklentiyi etkinleştirir.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInSecurityLevel trustLevel, System::String ^ appDomainName);

public T Activate<T> (System.AddIn.Hosting.AddInSecurityLevel trustLevel, string appDomainName);

member this.Activate : System.AddIn.Hosting.AddInSecurityLevel * string -> 'T

Public Function Activate(Of T) (trustLevel As AddInSecurityLevel, appDomainName As String) As T

Tür Parametreleri

T

Eklentinin konak görünümünü temsil eden arabirim veya soyut temel tür.

Parametreler

trustLevel: AddInSecurityLevel

Güven düzeyini belirten numaralandırma değerlerinden biri.

appDomainName: String

Yeni uygulama etki alanına atanacak kolay ad.

Döndürülenler

Eklentinin konak görünümü.

Açıklamalar

Bir uygulama etki alanı adı belirtmeniz gerekmiyorsa aşırı yüklemeyi kullanın Activate<T>(AddInSecurityLevel) .

Şunlara uygulanır

AddInToken.Activate Yöntem

Tanım

Aşırı Yüklemeler

Activate<T>(AddInEnvironment)

Tür Parametreleri

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Activate<T>(AddInSecurityLevel)

Tür Parametreleri

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Activate<T>(AppDomain)

Tür Parametreleri

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Activate<T>(PermissionSet)

Tür Parametreleri

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Activate<T>(AddInProcess, AddInSecurityLevel)

Tür Parametreleri

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Şunlara uygulanır

Activate<T>(AddInProcess, PermissionSet)

Tür Parametreleri

Parametreler

Döndürülenler

Açıklamalar

Şunlara uygulanır

Activate<T>(AddInSecurityLevel, String)

Tür Parametreleri

Parametreler

Döndürülenler

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar