IsPinned クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IsPinned クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

修飾されているインスタンスがメモリに固定されていることを示します。このクラスは継承できません。

名前空間: System.Runtime.CompilerServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 IsPinned

Visual Basic (使用法)

静的クラスのメンバは、クラスのインスタンスなしに直接アクセスされます。

public static class IsPinned

C++

public ref class IsPinned abstract sealed

public final class IsPinned

JScript

public final class IsPinned

解説

既定の動作が適切でない場合、コンパイラはメタデータ内のカスタム修飾子を出力して、Just-In-Time (JIT) コンパイラによる値の処理方法を変更します。JIT コンパイラは、カスタム修飾子を見つけると、その修飾子の指定に従って値を処理します。コンパイラは、メソッド、パラメータ、および戻り値に対してカスタム修飾子を適用します。JIT コンパイラは、オプションの修飾子は無視できますが、必須の修飾子については応答する必要があります。JIT コンパイラが既定で C++ と互換性のない方法でバイトを処理する場合に、バイトをどのように処理するかを定義するカスタム修飾子が C++ コンパイラから出力される場合があります。

次のいずれかの方法を使用して、カスタム修飾子をメタデータに出力できます。

DefineMethod、DefineField、DefineConstructor、DefineProperty などの TypeBuilder クラスでメソッドを使用します。
modopt および modreq の呼び出しを含む MSIL (Microsoft Intermediate Language) の命令ファイルを生成し、MSIL アセンブラ (Ilasm.exe) を使ってファイルをアセンブルします。
アンマネージリフレクション API を使用します。

使用例

リフレクションを使用して、IsPinned オブジェクトをアセンブリに出力する方法を次の例に示します。

C++


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

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