IsLong 類別

定義

命名空間:

System.Runtime.CompilerServices

組件:

System.Runtime.CompilerServices.VisualC.dll

表示修改的整數是標準 C++ long 值。 此類別無法獲得繼承。

public ref class IsLong abstract sealed

public static class IsLong

type IsLong = class

Public Class IsLong

繼承

Object

IsLong

範例

下列範例示範如何使用反映，將物件發出 IsLong 至元件。

#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 = {IsLong::typeid};

    mainClass->DefineField("modifiedInteger", Type::GetType("System.Int64"), 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.");
}

備註

C++ 標準表示 long 值和整數值是相異的類型。 不過，它們都會在 ELEMENT_TYPE_I4 元件中使用 來表示。 為了區別 long C++ 中的整數，Microsoft C++ 編譯器會在發出實例時，將修飾詞加入 IsLong 至 的任何實例 long 。 此程式對於維護語言層級型別安全性非常重要。

編譯器會在中繼資料內發出自訂修飾詞，以變更當預設行為不正確時，Just-In-Time (JIT) 編譯器處理值的方式。 當 JIT 編譯程式遇到自訂修飾詞時，它會以修飾詞指定的方式處理值。 編譯器可以將自訂修飾詞套用至方法、參數和傳回值。 JIT 編譯程式必須回應必要的修飾詞，但可以忽略選擇性修飾詞。

您可以使用下列其中一種技術，將自訂修飾詞發出至中繼資料：

• 在 類別中使用 TypeBuilder 方法，例如 DefineMethod 、 DefineField 、 DefineConstructor 和 DefineProperty 。

• 產生Microsoft中繼語言 (MSIL) 指令檔，其中包含 對 和 modreq 的呼叫 modopt ，並使用Ilasm.exe (IL 組合器) 來組合檔案。

• 使用 Unmanaged 反映 API。