LCIDConversionAttribute クラス

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

LCIDConversionAttribute クラス

メソッドのアンマネージ シグネチャにロケール識別子 (LCID) パラメータが必要であることを示します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Method, Inherited:=False)> _
Public NotInheritable Class
 LCIDConversionAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As LCIDConversionAttribute

C#

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)]
 
public sealed class LCIDConversionAttribute
 : Attribute

C++

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Method, Inherited=false)]
 
public ref class LCIDConversionAttribute sealed
 : public Attribute

J#

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)
 */ 
public final class LCIDConversionAttribute
 extends Attribute

JScript

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)
 
public final class LCIDConversionAttribute
 extends Attribute

解説

この属性は、メソッドに適用できます。

この属性は、マーシャラが、指定されたメソッド引数の後に LCID を渡すことを要求することを示します。マネージ コードからアンマネージ コードへの呼び出しが行われるときに、マーシャラが引数 LCID を自動的に指定します。

使用例

LCIDConversionAttribute に指定されるさまざまな値に応じて、シグネチャが変化するようすを次の例に示します。

Visual Basic

Imports System
Imports System.Runtime.InteropServices
Imports System.Reflection

Class LCIDAttrSampler

    Const LCID_INSTALLED As Integer
 = 1
    Const LCID_SUPPORTED As Integer
 = 2

    <DllImport("KERNEL32.DLL", EntryPoint:="IsValidLocale",
 _
    SetLastError:=True, CharSet:=CharSet.Unicode, _
    CallingConvention:=CallingConvention.StdCall), _
    LCIDConversionAttribute(0)> _
    Public Shared Function
 IsValidLocale(ByVal dwFlags As Integer)
 As Boolean
    End Function

    Public Sub CheckCurrentLCID()
        Dim mthIfo As MethodInfo = Me.GetType().GetMethod("IsValidLocale")
        Dim attr As Attribute = Attribute.GetCustomAttribute(mthIfo,
 GetType(LCIDConversionAttribute))

        If Not(attr Is Nothing)
 Then
            Dim lcidAttr As LCIDConversionAttribute
 = CType(attr, LCIDConversionAttribute)
            Console.WriteLine("Position of the LCID argument in
 the unmanaged signature: " + lcidAttr.Value.ToString())
        End If

        Dim res As Boolean
 = IsValidLocale(LCID_INSTALLED)
        Console.WriteLine("Result LCID_INSTALLED "
 + res.ToString())
        res = IsValidLocale(LCID_SUPPORTED)
        Console.WriteLine("Result LCID_SUPPORTED "
 + res.ToString())
    End Sub

    Public Shared Sub Main()
        Dim smpl As LCIDAttrSampler = New
 LCIDAttrSampler()
        smpl.CheckCurrentLCID()
    End Sub

End Class

C#

using System;
using System.Runtime.InteropServices;
using System.Reflection;

class LCIDAttrSample
{
    private const int LCID_INSTALLED
 = 1;
    private const int LCID_SUPPORTED
 = 2;

    [DllImport("KERNEL32.DLL", EntryPoint="IsValidLocale", SetLastError
 = true, CharSet = CharSet.Auto)]
    [LCIDConversionAttribute(0)] // Position of the LCID argument
    public static extern bool
 IsValidLocale(
                                                uint dwFlags            //
 options
                                            );

    public void CheckCurrentLCID()
    {
        MethodInfo mthIfo = this.GetType().GetMethod("IsValidLocale");
        Attribute attr = Attribute.GetCustomAttribute(mthIfo,typeof(LCIDConversionAttribute));

        if( attr != null)
        {
            LCIDConversionAttribute lcidAttr = (LCIDConversionAttribute)attr;
            Console.WriteLine("Position of the LCID argument in
 the unmanaged signature: " + lcidAttr.Value.ToString());
        }

        bool res = IsValidLocale(LCID_INSTALLED);
        Console.WriteLine("Result LCID_INSTALLED " + res.ToString());
        res = IsValidLocale(LCID_SUPPORTED);
        Console.WriteLine("Result LCID_SUPPORTED " + res.ToString());
    }

    static void Main(string[]
 args)
    {
        LCIDAttrSample smpl = new LCIDAttrSample();
        smpl.CheckCurrentLCID();
    }
}

C++

using namespace System;
using namespace System::Runtime::InteropServices;
using namespace System::Reflection;

#define LCID_INSTALLED 1
#define LCID_SUPPORTED 2

ref class LCIDAttrSample
{
public:

   // Position of the LCID argument

   [DllImport("KERNEL32.DLL",EntryPoint="IsValidLocale",SetLastError=true
,CharSet=CharSet::Auto)]
   [LCIDConversionAttribute(0)]
   static bool IsValidLocale( int
 dwFlags ); // options

   void CheckCurrentLCID()
   {
      MethodInfo^ mthIfo = this->GetType()->GetMethod( "IsValidLocale"
 );
      Attribute^ attr = Attribute::GetCustomAttribute( mthIfo, LCIDConversionAttribute::typeid
 );
      if ( attr != nullptr )
      {
         LCIDConversionAttribute^ lcidAttr = dynamic_cast<LCIDConversionAttribute^>(attr);
         Console::WriteLine( "Position of the LCID argument in
 the unmanaged signature: {0}", lcidAttr->Value );
      }

      bool res = IsValidLocale( LCID_INSTALLED );
      Console::WriteLine( "Result LCID_INSTALLED {0}", res );
      res = IsValidLocale( LCID_SUPPORTED );
      Console::WriteLine( "Result LCID_SUPPORTED {0}", res );
   }
};

int main()
{
   LCIDAttrSample^ smpl = gcnew LCIDAttrSample;
   smpl->CheckCurrentLCID();
}

J#

import System.*;
import System.Runtime.InteropServices.*;
import System.Reflection.*;

class LCIDAttrSample
{
    private static final int
 LCID_INSTALLED = 1;
    private static final int
 LCID_SUPPORTED = 2;
    
    /** @attribute DllImport("KERNEL32.DLL", EntryPoint = "IsValidLocale"
,
        SetLastError = true, CharSet = CharSet.Auto) 
     */
    /** @attribute LCIDConversionAttribute(0)
     */
    
    public static native boolean IsValidLocale(int
 dwFlags);

    // Position of the LCID argument options
    public void CheckCurrentLCID()
    {
        MethodInfo mthIfo = this.GetType().GetMethod("IsValidLocale");
        Attribute attr = Attribute.GetCustomAttribute(mthIfo,
            LCIDConversionAttribute.class.ToType());
        if (attr != null) {
            LCIDConversionAttribute lcidAttr = (LCIDConversionAttribute)attr;
            Console.WriteLine("Position of the LCID argument in
 the unmanaged "
                + "signature: " 
                + System.Convert.ToString(lcidAttr.get_Value()));
        }

        boolean res = IsValidLocale(LCID_INSTALLED);
        Console.WriteLine("Result LCID_INSTALLED " 
            + System.Convert.ToString(res));
        res = IsValidLocale(LCID_SUPPORTED);
        Console.WriteLine("Result LCID_SUPPORTED " 
            + System.Convert.ToString(res));
    } //CheckCurrentLCID

    public static void main(String[]
 args)
    {
        LCIDAttrSample smpl = new LCIDAttrSample();
        smpl.CheckCurrentLCID();
    } //main
} //LCIDAttrSample

継承階層

System.Object
   System.Attribute
    System.Runtime.InteropServices.LCIDConversionAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
LCIDConversionAttribute メンバ
System.Runtime.InteropServices 名前空間