IsExplicitlyDereferenced Klasa

Definicja

Wskazuje, że zarządzany wskaźnik reprezentuje parametr wskaźnika w sygnaturze metody.Indicates that a managed pointer represents a pointer parameter within a method signature. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class IsExplicitlyDereferenced abstract sealed
public static class IsExplicitlyDereferenced
type IsExplicitlyDereferenced = class
Public Class IsExplicitlyDereferenced
Dziedziczenie
IsExplicitlyDereferenced

Przykłady

W poniższym przykładzie pokazano, jak emitować obiekt IsExplicitlyDereferenced do zestawu przy użyciu odbicia.The following example demonstrates how to emit an IsExplicitlyDereferenced object into an assembly using reflection.



#using <mscorlib.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
using namespace System::Runtime::CompilerServices;
using namespace System::Threading;


ref class CodeEmitter
{
private:
    AssemblyBuilder^ asmBuilder;
    String^ asmName;
    ModuleBuilder^ modBuilder;


    void prepareAssembly(String^ name){
        
        // Check the input.
        if(!name){
        
            throw gcnew ArgumentNullException("AssemblyName");
        }

        asmName = name;

        // Create an AssemblyName object and set the name.
        AssemblyName^ asmName = gcnew AssemblyName();

        asmName->Name = name;

        // Use the AppDomain class to create an AssemblyBuilder instance.

        AppDomain^ currentDomain = Thread::GetDomain();

        asmBuilder = currentDomain->DefineDynamicAssembly(asmName,AssemblyBuilderAccess::RunAndSave);

        // Create a dynamic module.
        modBuilder = asmBuilder->DefineDynamicModule(name);
    }


public:

    // Constructor.
    CodeEmitter(String ^ AssemblyName){

        prepareAssembly(AssemblyName);
    }

    // Create a new type.
    TypeBuilder^ CreateType(String^ name){
       
        // Check the input.
        if(!name){
        
            throw gcnew ArgumentNullException("AssemblyName");
        }

        return modBuilder->DefineType( name );
    }

    // Write the assembly.
    void WriteAssembly(MethodBuilder^ entryPoint){
    
        // Check the input.
        if(!entryPoint){
        
            throw gcnew ArgumentNullException("entryPoint");
        }

        asmBuilder->SetEntryPoint( entryPoint );
        asmBuilder->Save( asmName );
    }

};

void main()
{

    // Create a CodeEmitter to handle assembly creation.
    CodeEmitter ^ e = gcnew CodeEmitter("program.exe");

    // Create a new type.
    TypeBuilder^ mainClass = e->CreateType("MainClass");
    
    // Create a new method.
    MethodBuilder^ mBuilder = mainClass->DefineMethod("mainMethod", MethodAttributes::Static);

    // Create an ILGenerator and emit IL for 
    // a simple "Hello World." program.
    ILGenerator^ ilGen = mBuilder->GetILGenerator();

    ilGen->Emit(OpCodes::Ldstr, "Hello World");

    array<Type^>^mType = {String::typeid};

    MethodInfo^ writeMI = Console::typeid->GetMethod( "WriteLine", mType );

    ilGen->EmitCall(OpCodes::Call, writeMI, nullptr );

    ilGen->Emit( OpCodes::Ret );

    /////////////////////////////////////////////////
    /////////////////////////////////////////////////
    // Apply a required custom modifier
    // to a field.
    /////////////////////////////////////////////////
    /////////////////////////////////////////////////

    array<Type^>^fType = {IsExplicitlyDereferenced::typeid};

    mainClass->DefineField("modifiedInteger", Type::GetType("System.IntPtr"), fType, nullptr, FieldAttributes::Private);

    // Create the type.
    mainClass->CreateType();

    // Write the assembly using a reference to 
    // the entry point.
    e->WriteAssembly(mBuilder);

    Console::WriteLine(L"Assembly created.");
}

Uwagi

W C++programie wskaźniki zarządzane i odwołania zarządzane są emitowane do metadanych jako wskaźniki.In C++, managed pointers and managed references are emitted into metadata as pointers. Aby rozróżnić dwa typy w metadanych, kompilator Microsoft C++ stosuje ten modyfikator do zarządzanych wskaźników.To distinguish between the two types in metadata, the Microsoft C++ compiler applies this modifier to managed pointers. Emituje nie Modyfikatory dla zarządzanych typów odwołań.It emits no modifier on managed reference types. Kompilatory muszą znać poprawną składnię wywołującą podczas importowania metody z zakresu metadanych.Compilers need to know the correct calling syntax when importing a method from metadata scope. Klasa IsExplicitlyDereferenced i jej partner, Klasa IsImplicitlyDereferenced, odróżnienia parametrów referencyjnych od parametrów wskaźnika.The IsExplicitlyDereferenced class and its partner, the IsImplicitlyDereferenced class, disambiguate reference parameters from pointer parameters.

Kompilatory emitują Modyfikatory niestandardowe w metadanych, aby zmienić sposób, w jaki kompilator just-in-Time (JIT) obsługuje wartości, gdy zachowanie domyślne jest nieodpowiednie.Compilers emit custom modifiers within metadata to change the way that the just-in-time (JIT) compiler handles values when the default behavior is not appropriate. Gdy kompilator JIT napotyka modyfikator niestandardowy, obsługuje wartość w sposób określany przez modyfikator.When the JIT compiler encounters a custom modifier, it handles the value in the way that the modifier specifies. Kompilatory mogą stosować Modyfikatory niestandardowe do metod, parametrów i zwracanych wartości.Compilers can apply custom modifiers to methods, parameters, and return values. Kompilator JIT musi odpowiadać na wymagane modyfikatory, ale może ignorować opcjonalne modyfikatory.The JIT compiler must respond to required modifiers but can ignore optional modifiers.

Modyfikatory niestandardowe można emitować do metadanych przy użyciu jednej z następujących technik:You can emit custom modifiers into metadata using one of the following techniques:

Dotyczy