ComRegisterFunctionAttribute Sınıf

Başvuru

Tanım

Ad Alanı:: System.Runtime.InteropServices

Bütünleştirilmiş Kod:: System.Runtime.InteropServices.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.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.

COM'dan kullanmak üzere bir derleme kaydettiğinizde çağrılacak yöntemi belirtir; bu, kayıt işlemi sırasında kullanıcı tarafından yazılan kodun yürütülmesini sağlar.

public ref class ComRegisterFunctionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class ComRegisterFunctionAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComRegisterFunctionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ComRegisterFunctionAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComRegisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute

Devralma: Object

Attribute
ComRegisterFunctionAttribute

Öznitelikler: AttributeUsageAttribute ComVisibleAttribute

Örnekler

Aşağıdaki örnekte, uygun imzaya sahip yöntemlere nasıl ve ComUnregisterFunctionAttribute uygulanacağı ComRegisterFunctionAttribute gösterilmektedir.

using namespace System;
using namespace System::Runtime::InteropServices;
public ref class MyClassThatNeedsToRegister
{
public:

   [ComRegisterFunctionAttribute]
   static void RegisterFunction( Type^ t )
   {
      
      //Insert code here.
   }


   [ComUnregisterFunctionAttribute]
   static void UnregisterFunction( Type^ t )
   {
      
      //Insert code here.
   }

};

using System;
using System.Runtime.InteropServices;

public class MyClassThatNeedsToRegister
{
   [ComRegisterFunctionAttribute]
   public static void RegisterFunction(Type t)
   {
      //Insert code here.
   }

   [ComUnregisterFunctionAttribute]
   public static void UnregisterFunction(Type t)
   {
      //Insert code here.
   }
}

Imports System.Runtime.InteropServices

Public Class MyClassThatNeedsToRegister
    
    <ComRegisterFunctionAttribute()> Public Shared Sub _
      RegisterFunction(t As Type)
        'Insert code here.
    End Sub
    
    <ComUnregisterFunctionAttribute()> Public Shared Sub _
      UnregisterFunction(t As Type)
        'Insert code here.
    End Sub
End Class

Açıklamalar

Bu özniteliği yöntemlere uygulayabilirsiniz.

ComRegisterFunctionAttribute , COM istemcilerinin gereksinimlerini karşılamak için rastgele kayıt kodu eklemenize olanak tanır. Örneğin, ad alanından kayıt işlevlerini Microsoft.Win32 kullanarak kayıt defterini güncelleştirebilirsiniz. Bir kayıt yöntemi sağlarsanız, kayıt yönteminde gerçekleştirilen işlemleri tersine çeviren bir kayıt kaldırma yöntemine de uygulamanız System.Runtime.InteropServices.ComUnregisterFunctionAttribute gerekir.

.NET Framework: Ortak dil çalışma zamanı, içeren derlemesiRegasm.exe (Derleme Kaydı) aracıyla (doğrudan veya dolaylı olarak) veya yöntemi aracılığıyla RegistrationServices.RegisterAssembly kaydedildiğinde yöntemini bu öznitelikle çağırır.

.NET Core: Ortak dil çalışma zamanı, derlemenin COM ana bilgisayarı RegSvr32.exe aracı aracılığıyla kaydedildiğinde yöntemini bu öznitelikle çağırır.

Bu öznitelik yalnızca aşağıdaki özelliklere sahip yöntemlere uygulanabilir:

Kapsam: Herhangi biri (genel, özel vb.).
Şunu yazın: static.
Parametreler: Tek Type bir parametreyi veya String parametre türünü kabul eder.
Dönüş türü: void.

Oluşturucular

ComRegisterFunctionAttribute()

ComRegisterFunctionAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır.

(Devralındığı yer: Attribute)

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1). (Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bir nesne tarafından sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute)

Şunlara uygulanır