ComRegisterFunctionAttribute Osztály

Definíció

Névtér:

System.Runtime.InteropServices

Szerelvények:

netstandard.dll, System.Runtime.InteropServices.dll

Forrás:

ComRegisterFunctionAttribute.cs

Megadja azt a metódust, amelyet meghívhat, amikor regisztrál egy szerelvényt a COM-ból való használatra; ez lehetővé teszi a felhasználó által írt kód végrehajtását a regisztrációs folyamat során.

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)>]
type ComRegisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute

Öröklődés

Object

Attribute

ComRegisterFunctionAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan alkalmazhatók ComRegisterFunctionAttribute és ComUnregisterFunctionAttribute alkalmazhatók a megfelelő aláírással rendelkező metódusok.

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

Megjegyzések

Ezt az attribútumot alkalmazhatja a metódusokra.

ComRegisterFunctionAttribute lehetővé teszi tetszőleges regisztrációs kód hozzáadását a COM-ügyfelek igényeinek megfelelően. A beállításjegyzéket például a Microsoft.Win32 névtér regisztrációs függvényeivel frissítheti. Ha regisztrációs módszert ad meg, akkor egy regisztráció nélküli módszerre is alkalmaznia System.Runtime.InteropServices.ComUnregisterFunctionAttribute kell, amely megfordítja a regisztrációs módszerben végrehajtott műveleteket.

.NET Framework: A közös nyelvi futtatókörnyezet meghívja ezt az attribútumot, ha a szerelvényt tartalmazó szerelvényt (közvetlenül vagy közvetve) regisztrálja a Regasm.exe (Szerelvényregisztráció) eszközzel) vagy a RegistrationServices.RegisterAssembly metóduson keresztül.

.NET Core: A közös nyelvi futtatókörnyezet ezzel az attribútummal hívja meg a metódust, amikor a szerelvény COM-gazdagépét a RegSvr32.exe eszközzel regisztrálják.

Ez az attribútum csak az alábbi jellemzőkkel rendelkező metódusokra alkalmazható:

• Hatókör: Bármely (nyilvános, privát stb.).

• Típus: static.

• Paraméterek: Egyetlen Type paramétert vagy paramétertípust String fogad el.

• Visszatérési típus: void.

Konstruktorok

Name	Description
ComRegisterFunctionAttribute()	Inicializálja a ComRegisterFunctionAttribute osztály új példányát.

Tulajdonságok

Name	Description
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (Szerelvényregisztrációs eszköz)