ModuleBuilder.DefineGlobalMethod Метод

Определение

Определяет глобальный метод.Defines a global method.

Перегрузки

DefineGlobalMethod(String, MethodAttributes, Type, Type[])

Определяет глобальный метод с данными именем, атрибутами, возвращаемыми типами и типами параметров.Defines a global method with the specified name, attributes, return type, and parameter types.

DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])

Определяет глобальный метод с данными именем, атрибутами, соглашениями о вызовах, возвращаемыми типами и типами параметров.Defines a global method with the specified name, attributes, calling convention, return type, and parameter types.

DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])

Определяет глобальный метод с данными именем, атрибутами, соглашениями о вызовах, возвращаемым типом, пользовательскими модификаторами для возвращаемого типа, типами параметров и пользовательскими модификаторами для типов параметров.Defines a global method with the specified name, attributes, calling convention, return type, custom modifiers for the return type, parameter types, and custom modifiers for the parameter types.

DefineGlobalMethod(String, MethodAttributes, Type, Type[])

Определяет глобальный метод с данными именем, атрибутами, возвращаемыми типами и типами параметров.Defines a global method with the specified name, attributes, return type, and parameter types.

public:
 System::Reflection::Emit::MethodBuilder ^ DefineGlobalMethod(System::String ^ name, System::Reflection::MethodAttributes attributes, Type ^ returnType, cli::array <Type ^> ^ parameterTypes);
public System.Reflection.Emit.MethodBuilder DefineGlobalMethod (string name, System.Reflection.MethodAttributes attributes, Type? returnType, Type[]? parameterTypes);
public System.Reflection.Emit.MethodBuilder DefineGlobalMethod (string name, System.Reflection.MethodAttributes attributes, Type returnType, Type[] parameterTypes);
member this.DefineGlobalMethod : string * System.Reflection.MethodAttributes * Type * Type[] -> System.Reflection.Emit.MethodBuilder
Public Function DefineGlobalMethod (name As String, attributes As MethodAttributes, returnType As Type, parameterTypes As Type()) As MethodBuilder

Параметры

name
String

Имя метода.The name of the method. Параметр name не может содержать внедренные значения NULL.name cannot contain embedded nulls.

attributes
MethodAttributes

Атрибуты метода.The attributes of the method. Параметр attributes должен включать атрибут Static.attributes must include Static.

returnType
Type

Тип возвращаемых данных метода.The return type of the method.

parameterTypes
Type[]

Типы параметров метода.The types of the method's parameters.

Возвращаемое значение

MethodBuilder

Определенный глобальный метод.The defined global method.

Исключения

Метод не является статическим.The method is not static. То есть параметр attributes не включает Static.That is, attributes does not include Static.

-или--or- Длина параметра name равна нулю.The length of name is zero -или--or- Элементом массива Type является null.An element in the Type array is null.

name имеет значение null.name is null.

CreateGlobalFunctions() был вызван ранее.CreateGlobalFunctions() has been previously called.

Примеры

В следующем примере показано использование DefineGlobalMethod для создания независимого от типа метода, привязанного к текущему ModuleBuilder .The following example illustrates the use of DefineGlobalMethod to create a type-independent method tied to the current ModuleBuilder. После создания глобального метода CreateGlobalFunctions необходимо вызвать метод, чтобы выполнить его.After building the global method, CreateGlobalFunctions must be called in order to complete it.

AppDomain^ currentDomain;
AssemblyName^ myAssemblyName;
MethodBuilder^ myMethodBuilder = nullptr;
ILGenerator^ myILGenerator;

// Get the current application domain for the current thread.
currentDomain = AppDomain::CurrentDomain;
myAssemblyName = gcnew AssemblyName;
myAssemblyName->Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = 
   currentDomain->DefineDynamicAssembly(
      myAssemblyName, AssemblyBuilderAccess::RunAndSave );

// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder->DefineDynamicModule( "TempModule" );

// Define a global method in the 'TempModule' module.
myMethodBuilder = myModuleBuilder->DefineGlobalMethod(
   "MyMethod1", (MethodAttributes)(MethodAttributes::Static | MethodAttributes::Public),
   nullptr, nullptr );
myILGenerator = myMethodBuilder->GetILGenerator();
myILGenerator->EmitWriteLine( "Hello World from global method." );
myILGenerator->Emit( OpCodes::Ret );

// Fix up the 'TempModule' module .
myModuleBuilder->CreateGlobalFunctions();
AppDomain currentDomain;
AssemblyName myAssemblyName;
MethodBuilder myMethodBuilder=null;
ILGenerator myILGenerator;

// Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain;
myAssemblyName = new AssemblyName();
myAssemblyName.Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder =
   currentDomain.DefineDynamicAssembly
               (myAssemblyName, AssemblyBuilderAccess.RunAndSave);
// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule");

// Define a global method in the 'TempModule' module.
myMethodBuilder = myModuleBuilder.DefineGlobalMethod
     ("MyMethod1",MethodAttributes.Static|MethodAttributes.Public,
           null,null);
myILGenerator = myMethodBuilder.GetILGenerator();
myILGenerator.EmitWriteLine("Hello World from global method.");
myILGenerator.Emit(OpCodes.Ret);
// Fix up the 'TempModule' module .
myModuleBuilder.CreateGlobalFunctions();
Dim currentDomain As AppDomain
Dim myAssemblyName As AssemblyName
Dim myMethodBuilder As MethodBuilder = Nothing
Dim myILGenerator As ILGenerator

' Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain
myAssemblyName = New AssemblyName()
myAssemblyName.Name = "TempAssembly"

' Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = currentDomain.DefineDynamicAssembly(myAssemblyName, _
                                                   AssemblyBuilderAccess.RunAndSave)
' Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")

' Define a global method in the 'TempModule' module.
myMethodBuilder = myModuleBuilder.DefineGlobalMethod("MyMethod1", MethodAttributes.Static _
                                          Or MethodAttributes.Public, Nothing, Nothing)
myILGenerator = myMethodBuilder.GetILGenerator()
myILGenerator.EmitWriteLine("Hello World from global method.")
myILGenerator.Emit(OpCodes.Ret)
' Fix up the 'TempModule' module .
myModuleBuilder.CreateGlobalFunctions()

Комментарии

Глобальный метод, определяемый этим методом, не может использоваться до тех пор, пока не будет вызван CreateGlobalFunctions .The global method that this method defines is not usable until you call CreateGlobalFunctions.

Примечание

Начиная с .NET Framework 2.0 с пакетом обновления 1 (SP1).NET Framework 2.0 Service Pack 1 , этот член больше не требует наличия ReflectionPermission ReflectionPermissionFlag.ReflectionEmit флага.Starting with the .NET Framework 2.0 с пакетом обновления 1 (SP1).NET Framework 2.0 Service Pack 1, this member no longer requires ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag. (См. раздел вопросы безопасности в порождении отражения.) Чтобы использовать эту функцию, приложение должно быть предназначено для .NET Framework 3,5.NET Framework 3.5 или более поздней версии.(See Security Issues in Reflection Emit.) To use this functionality, your application should target the .NET Framework 3,5.NET Framework 3.5 or later.

Применяется к

DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])

Определяет глобальный метод с данными именем, атрибутами, соглашениями о вызовах, возвращаемыми типами и типами параметров.Defines a global method with the specified name, attributes, calling convention, return type, and parameter types.

public:
 System::Reflection::Emit::MethodBuilder ^ DefineGlobalMethod(System::String ^ name, System::Reflection::MethodAttributes attributes, System::Reflection::CallingConventions callingConvention, Type ^ returnType, cli::array <Type ^> ^ parameterTypes);
public System.Reflection.Emit.MethodBuilder DefineGlobalMethod (string name, System.Reflection.MethodAttributes attributes, System.Reflection.CallingConventions callingConvention, Type? returnType, Type[]? parameterTypes);
public System.Reflection.Emit.MethodBuilder DefineGlobalMethod (string name, System.Reflection.MethodAttributes attributes, System.Reflection.CallingConventions callingConvention, Type returnType, Type[] parameterTypes);
member this.DefineGlobalMethod : string * System.Reflection.MethodAttributes * System.Reflection.CallingConventions * Type * Type[] -> System.Reflection.Emit.MethodBuilder
Public Function DefineGlobalMethod (name As String, attributes As MethodAttributes, callingConvention As CallingConventions, returnType As Type, parameterTypes As Type()) As MethodBuilder

Параметры

name
String

Имя метода.The name of the method. Параметр name не может содержать внедренные значения NULL.name cannot contain embedded nulls.

attributes
MethodAttributes

Атрибуты метода.The attributes of the method. Параметр attributes должен включать атрибут Static.attributes must include Static.

callingConvention
CallingConventions

Соглашение о вызовах для метода.The calling convention for the method.

returnType
Type

Тип возвращаемых данных метода.The return type of the method.

parameterTypes
Type[]

Типы параметров метода.The types of the method's parameters.

Возвращаемое значение

MethodBuilder

Определенный глобальный метод.The defined global method.

Исключения

Метод не является статическим.The method is not static. То есть параметр attributes не включает Static.That is, attributes does not include Static.

-или--or- Элементом массива Type является null.An element in the Type array is null.

name имеет значение null.name is null.

CreateGlobalFunctions() был вызван ранее.CreateGlobalFunctions() has been previously called.

Примеры

В следующем образце кода показано использование DefineGlobalMethod для создания независимого от типа метода, привязанного к текущему ModuleBuilder .The following code sample illustrates the use of DefineGlobalMethod to create a type-independent method tied to the current ModuleBuilder. После создания глобального метода CreateGlobalFunctions необходимо вызвать метод, чтобы выполнить его.After building the global method, CreateGlobalFunctions must be called in order to complete it.

AppDomain^ currentDomain;
AssemblyName^ myAssemblyName;
MethodBuilder^ myMethodBuilder = nullptr;
ILGenerator^ myILGenerator;

// Get the current application domain for the current thread.
currentDomain = AppDomain::CurrentDomain;
myAssemblyName = gcnew AssemblyName;
myAssemblyName->Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = 
   currentDomain->DefineDynamicAssembly(
      myAssemblyName, AssemblyBuilderAccess::RunAndSave );

// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder->DefineDynamicModule( "TempModule" );

// Define a global method in the 'TempModule' module.
myMethodBuilder = myModuleBuilder->DefineGlobalMethod(
   "MyMethod1", (MethodAttributes)(MethodAttributes::Static | MethodAttributes::Public),
   nullptr, nullptr );
myILGenerator = myMethodBuilder->GetILGenerator();
myILGenerator->EmitWriteLine( "Hello World from global method." );
myILGenerator->Emit( OpCodes::Ret );

// Fix up the 'TempModule' module .
myModuleBuilder->CreateGlobalFunctions();
AppDomain currentDomain;
AssemblyName myAssemblyName;
MethodBuilder myMethodBuilder=null;
ILGenerator myILGenerator;

// Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain;
myAssemblyName = new AssemblyName();
myAssemblyName.Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder =
   currentDomain.DefineDynamicAssembly
               (myAssemblyName, AssemblyBuilderAccess.RunAndSave);
// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule");

// Define a global method in the 'TempModule' module.
myMethodBuilder = myModuleBuilder.DefineGlobalMethod
     ("MyMethod1",MethodAttributes.Static|MethodAttributes.Public,
           null,null);
myILGenerator = myMethodBuilder.GetILGenerator();
myILGenerator.EmitWriteLine("Hello World from global method.");
myILGenerator.Emit(OpCodes.Ret);
// Fix up the 'TempModule' module .
myModuleBuilder.CreateGlobalFunctions();
Dim currentDomain As AppDomain
Dim myAssemblyName As AssemblyName
Dim myMethodBuilder As MethodBuilder = Nothing
Dim myILGenerator As ILGenerator

' Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain
myAssemblyName = New AssemblyName()
myAssemblyName.Name = "TempAssembly"

' Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = currentDomain.DefineDynamicAssembly(myAssemblyName, _
                                                   AssemblyBuilderAccess.RunAndSave)
' Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")

' Define a global method in the 'TempModule' module.
myMethodBuilder = myModuleBuilder.DefineGlobalMethod("MyMethod1", MethodAttributes.Static _
                                          Or MethodAttributes.Public, Nothing, Nothing)
myILGenerator = myMethodBuilder.GetILGenerator()
myILGenerator.EmitWriteLine("Hello World from global method.")
myILGenerator.Emit(OpCodes.Ret)
' Fix up the 'TempModule' module .
myModuleBuilder.CreateGlobalFunctions()

Комментарии

Глобальный метод, определяемый этим методом, нельзя использовать до вызова метода CreateGlobalFunctions .You cannot use the global method that this method defines until you call CreateGlobalFunctions.

Примечание

Начиная с .NET Framework 2.0 с пакетом обновления 1 (SP1).NET Framework 2.0 Service Pack 1 , этот член больше не требует наличия ReflectionPermission ReflectionPermissionFlag.ReflectionEmit флага.Starting with the .NET Framework 2.0 с пакетом обновления 1 (SP1).NET Framework 2.0 Service Pack 1, this member no longer requires ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag. (См. раздел вопросы безопасности в порождении отражения.) Чтобы использовать эту функцию, приложение должно быть предназначено для .NET Framework 3,5.NET Framework 3.5 или более поздней версии.(See Security Issues in Reflection Emit.) To use this functionality, your application should target the .NET Framework 3,5.NET Framework 3.5 or later.

Применяется к

DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])

Определяет глобальный метод с данными именем, атрибутами, соглашениями о вызовах, возвращаемым типом, пользовательскими модификаторами для возвращаемого типа, типами параметров и пользовательскими модификаторами для типов параметров.Defines a global method with the specified name, attributes, calling convention, return type, custom modifiers for the return type, parameter types, and custom modifiers for the parameter types.

public:
 System::Reflection::Emit::MethodBuilder ^ DefineGlobalMethod(System::String ^ name, System::Reflection::MethodAttributes attributes, System::Reflection::CallingConventions callingConvention, Type ^ returnType, cli::array <Type ^> ^ requiredReturnTypeCustomModifiers, cli::array <Type ^> ^ optionalReturnTypeCustomModifiers, cli::array <Type ^> ^ parameterTypes, cli::array <cli::array <Type ^> ^> ^ requiredParameterTypeCustomModifiers, cli::array <cli::array <Type ^> ^> ^ optionalParameterTypeCustomModifiers);
public System.Reflection.Emit.MethodBuilder DefineGlobalMethod (string name, System.Reflection.MethodAttributes attributes, System.Reflection.CallingConventions callingConvention, Type? returnType, Type[]? requiredReturnTypeCustomModifiers, Type[]? optionalReturnTypeCustomModifiers, Type[]? parameterTypes, Type[][]? requiredParameterTypeCustomModifiers, Type[][]? optionalParameterTypeCustomModifiers);
public System.Reflection.Emit.MethodBuilder DefineGlobalMethod (string name, System.Reflection.MethodAttributes attributes, System.Reflection.CallingConventions callingConvention, Type returnType, Type[] requiredReturnTypeCustomModifiers, Type[] optionalReturnTypeCustomModifiers, Type[] parameterTypes, Type[][] requiredParameterTypeCustomModifiers, Type[][] optionalParameterTypeCustomModifiers);
member this.DefineGlobalMethod : string * System.Reflection.MethodAttributes * System.Reflection.CallingConventions * Type * Type[] * Type[] * Type[] * Type[][] * Type[][] -> System.Reflection.Emit.MethodBuilder
Public Function DefineGlobalMethod (name As String, attributes As MethodAttributes, callingConvention As CallingConventions, returnType As Type, requiredReturnTypeCustomModifiers As Type(), optionalReturnTypeCustomModifiers As Type(), parameterTypes As Type(), requiredParameterTypeCustomModifiers As Type()(), optionalParameterTypeCustomModifiers As Type()()) As MethodBuilder

Параметры

name
String

Имя метода.The name of the method. Параметр name не должен содержать внедренные символы NULL.name cannot contain embedded null characters.

attributes
MethodAttributes

Атрибуты метода.The attributes of the method. Параметр attributes должен включать атрибут Static.attributes must include Static.

callingConvention
CallingConventions

Соглашение о вызовах для метода.The calling convention for the method.

returnType
Type

Тип возвращаемых данных метода.The return type of the method.

requiredReturnTypeCustomModifiers
Type[]

Массив типов представляет собой требуемые пользовательские модификаторы для возвращаемого типа, например IsConst или IsBoxed.An array of types representing the required custom modifiers for the return type, such as IsConst or IsBoxed. Если возвращаемый тип не содержит требуемых настраиваемых модификаторов, укажите null.If the return type has no required custom modifiers, specify null.

optionalReturnTypeCustomModifiers
Type[]

Массив типов представляет собой необязательные пользовательские модификаторы для возвращаемого типа, например IsConst или IsBoxed.An array of types representing the optional custom modifiers for the return type, such as IsConst or IsBoxed. Если возвращаемый тип не содержит необязательные настраиваемые модификаторы, укажите null.If the return type has no optional custom modifiers, specify null.

parameterTypes
Type[]

Типы параметров метода.The types of the method's parameters.

requiredParameterTypeCustomModifiers
Type[][]

Массив массивов типов.An array of arrays of types. Каждый массив типов представляет собой требуемые пользовательские модификаторы для соответствующего параметра глобального метода.Each array of types represents the required custom modifiers for the corresponding parameter of the global method. Если определенный аргумент не содержит требуемые пользовательские модификаторы, вместо массива данных укажите null.If a particular argument has no required custom modifiers, specify null instead of an array of types. Если глобальный метод не содержит аргументов или если аргументы не содержат пользовательские модификаторы, укажите значение null вместо массива массивов.If the global method has no arguments, or if none of the arguments have required custom modifiers, specify null instead of an array of arrays.

optionalParameterTypeCustomModifiers
Type[][]

Массив массивов типов.An array of arrays of types. Каждый массив типов представляет собой необязательные пользовательские модификаторы для соответствующего параметра.Each array of types represents the optional custom modifiers for the corresponding parameter. Если определенный аргумент не содержит необязательные пользовательские модификаторы, вместо массива данных укажите null.If a particular argument has no optional custom modifiers, specify null instead of an array of types. Если глобальный метод не содержит аргументов или если аргументы не содержат необязательные пользовательские модификаторы, укажите значение null вместо массива массивов.If the global method has no arguments, or if none of the arguments have optional custom modifiers, specify null instead of an array of arrays.

Возвращаемое значение

MethodBuilder

Определенный глобальный метод.The defined global method.

Исключения

Метод не является статическим.The method is not static. То есть параметр attributes не включает Static.That is, attributes does not include Static.

-или--or- Элементом массива Type является null.An element in the Type array is null.

name имеет значение null.name is null.

Метод CreateGlobalFunctions() вызывался до этого.The CreateGlobalFunctions() method has been previously called.

Комментарии

Эта перегрузка предоставляется для конструкторов управляемых компиляторов.This overload is provided for designers of managed compilers.

Глобальный метод, определяемый этим методом, нельзя использовать до вызова метода CreateGlobalFunctions .You cannot use the global method that this method defines until you call CreateGlobalFunctions.

Примечание

Начиная с .NET Framework 2.0 с пакетом обновления 1 (SP1).NET Framework 2.0 Service Pack 1 , этот член больше не требует наличия ReflectionPermission ReflectionPermissionFlag.ReflectionEmit флага.Starting with the .NET Framework 2.0 с пакетом обновления 1 (SP1).NET Framework 2.0 Service Pack 1, this member no longer requires ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag. (См. раздел вопросы безопасности в порождении отражения.) Чтобы использовать эту функцию, приложение должно быть предназначено для .NET Framework 3,5.NET Framework 3.5 или более поздней версии.(See Security Issues in Reflection Emit.) To use this functionality, your application should target the .NET Framework 3,5.NET Framework 3.5 or later.

Применяется к