BestFitMappingAttribute Sınıf

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Kaynak:

BestFitMappingAttribute.cs

Unicode karakterlerinin en yakın eşleşen ANSI karakterlerine dönüştürülip dönüştürülmeyeceğini denetler.

public ref class BestFitMappingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Struct, Inherited=false)]
public sealed class BestFitMappingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Struct, Inherited=false)>]
type BestFitMappingAttribute = class
    inherit Attribute

Public NotInheritable Class BestFitMappingAttribute
Inherits Attribute

Devralma

Object

Attribute

BestFitMappingAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnekte en uygun eşlemenin nasıl devre dışı bırakılıp Unicode karakterlerinin '?' olarak dönüştürülmesiyle ilgili bir özel durum oluşturma işlemi gösterilmektedir ANSI karakteri. Parametreleri bu şekilde ayarlamak BestFitMappingAttribute ek bir güvenlik ölçüsü sağlar.

[BestFitMapping(false, ThrowOnUnmappableChar = true)]
interface class IMyInterface1
{
     //Insert code here.
};

[BestFitMapping(false, ThrowOnUnmappableChar = true)]
interface IMyInterface1
{
     //Insert code here.
}

<BestFitMapping(False, ThrowOnUnmappableChar := True)> _
Interface IMyInterface1
     'Insert code here.
End Interface

Açıklamalar

Bu özniteliği bir derlemeye, arabirime, sınıfa veya yapıya uygulayabilirsiniz.

Caution

Bazı karakterlerin en uygun gösterimi yok; bu karakterlere unmappable adı verilir. Tanınmayan karakterler genellikle varsayılan '?' değerine dönüştürülür ANSI karakteri. Bazı Unicode karakterleri, bir yolu yanlışlıkla değiştirebilen ters eğik çizgi '\' karakteri gibi tehlikeli karakterlere dönüştürülür.

BestFitMappingAttribute , en uygun eşlemenin yönlerini denetlemek için iki parametre sağlar. en uygun eşlemeyi açmak ve kapatmak için ilk parametreyi kullanırsınız. Varsayılan değer, derleme, arabirim ve sınıf düzeylerinde en uygun eşlemeyi sağlayan değeridir true. Arabirime veya sınıfa uygulanan bir öznitelik, derleme düzeyi özniteliğini geçersiz kılar. Benzer şekilde alanını kullanarak platform çağırma çağrıları için en uygun eşlemeyi DllImportAttribute.BestFitMapping etkinleştirebilir veya devre dışı bırakabilirsiniz. Platform çağırma alanı tarafından ayarlanan bir değer, tüm düzeylerini BestFitMappingAttributegeçersiz kılar.

İkinci parametreyi, uygulamaz karakterlere özel durum oluşturma işlemini denetlemek için kullanabilirsiniz. Alanının varsayılan değeri ThrowOnUnmappableChar , falseçalışma zamanı '?' öğesine dönüştürülmesi gereken bir Unicode karakteriyle her karşılaştığında özel durum oluşturmayı devre dışı bırakır. ANSI karakteri. En uygun eşleme olsa bile, alanı trueolduğundaThrowOnUnmappableChartrue, eşlenemeyen karakterler bir özel durum oluşturur. Güvenliği sıkılaştırmak için, ilk parametreyi olarak false , ikinci parametreyi trueolarak değiştirebilirsiniz. Parametre ayarlarının bu birleşimi en uygun eşlemeyi kapatır, ancak güvenlik önlemi olarak özel durum oluşturma mekanizmasını etkinleştirir.

Caution

Öğeleri ANSI Chars veya LPSTR olan yönetilen bir dizi yönetilmeyen güvenli bir diziye geçirilirken tarafından BestFitMappingAttribute sağlanan varsayılan değerleri değiştiremezsiniz. En uygun eşleme her zaman etkindir ve özel durum oluşturulamıyor. Bu birleşimin güvenlik modelinizi tehlikeye atabileceğini unutmayın.

Oluşturucular

Name	Description
BestFitMappingAttribute(Boolean)	özelliğinin BestFitMappingAttribute değerine ayarlanmış sınıfın yeni bir örneğini BestFitMapping başlatır.

Alanlar

Name	Description
ThrowOnUnmappableChar	ANSI '?' karakterine dönüştürülen, uygulamaz bir Unicode karakteri üzerinde özel durum oluşturma işlemini etkinleştirir veya devre dışı bırakır.

Özellikler

Name	Description
BestFitMapping	Unicode karakterleri ANSI karakterlerine dönüştürülürken en uygun eşleme davranışını alır.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• BestFitMapping
• Interop Yönlendirme