EncodingProvider.GetEncoding Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir kodlama döndürür.

Aşırı Yüklemeler

GetEncoding(Int32)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür.
GetEncoding(String)	Belirtilen ada sahip kodlamayı döndürür.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.
GetEncoding(String, EncoderFallback, DecoderFallback)	Belirtilen adla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.

GetEncoding(Int32)

Kaynak:

EncodingProvider.cs

Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür.

public:
 abstract System::Text::Encoding ^ GetEncoding(int codepage);

public abstract System.Text.Encoding? GetEncoding (int codepage);

abstract member GetEncoding : int -> System.Text.Encoding

Public MustOverride Function GetEncoding (codepage As Integer) As Encoding

Parametreler

codepage

Int32

İstenen kodlamanın kod sayfası tanımlayıcısı.

Döndürülenler

Encoding

Belirtilen kod sayfasıyla ilişkili kodlama veya null buna EncodingProvider karşılık gelen codepagegeçerli bir kodlama döndüremiyorsa.

Açıklamalar

Arayanlara notlar

Bu yöntem Encoding.GetEncoding(Int32) yöntemi tarafından çağrılır. Bunu doğrudan kullanıcı kodundan çağırmamalısınız.

Uygulayanlara Notlar

Alt sınıfınız tarafından desteklenen kodlamaları veya kodlamaları döndürmek için yöntemini geçersiz kılarsınız GetEncoding(Int32)EncodingProvider . Kullanıcı kodu yöntemini çağırarak GetEncoding(Int32) bir kodlama almayı denediğinde, yöntem tanımlayıcıyı codepage geçerli bir kodlama döndürene kadar her kayıtlı kodlama sağlayıcısına geçirir. Hiçbiri geçerli bir kodlama döndürmezse, GetEncoding(Int32) yöntem kod sayfası tanımlayıcısı codepageolan önbelleğe alınmış bir kodlamayı almaya çalışır. Bu nedenle, desteklediğiniz bir kodlamanın kod sayfası tanımlayıcısı değilse codepage yöntemi döndürmelidir null; hiçbir zaman özel durum oluşturmamalıdır.

Arayanlara Notlar

Bu yöntem yöntemi tarafından çağrılır GetEncoding(Int32) . Bunu doğrudan kullanıcı kodundan çağırmamalısınız.

Ayrıca bkz.

• GetEncoding(Int32)

GetEncoding(String)

Kaynak:

EncodingProvider.cs

Belirtilen ada sahip kodlamayı döndürür.

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);

public abstract System.Text.Encoding? GetEncoding (string name);

abstract member GetEncoding : string -> System.Text.Encoding

Public MustOverride Function GetEncoding (name As String) As Encoding

Parametreler

name

String

İstenen kodlamanın adı.

Döndürülenler

Encoding

Belirtilen adla ilişkili kodlama veya null buna EncodingProvider karşılık gelen namegeçerli bir kodlama döndüremiyorsa.

Açıklamalar

Devralanlara notlar

Alt sınıfınız tarafından desteklenen kodlamaları veya kodlamaları döndürmek için GetEncoding(String) yöntemini geçersiz kılarsınız EncodingProvider . Kullanıcı kodu GetEncoding(String) yöntemini çağırarak bir kodlama almaya çalıştığında, yöntem bağımsız değişkeni geçerli bir kodlama döndürene kadar her kayıtlı kodlama sağlayıcısına geçirir name . Hiçbiri geçerli bir kodlama döndürmezse, GetEncoding(String) yöntemi adı nameolan önbelleğe alınmış bir kodlama almayı dener. Bu nedenle, desteklediğiniz bir kodlamanın adı değilse name yöntemi döndürmelidir null. Yönteminin bir özel durum oluşturması gereken tek durum ise name olur null.

Arayanlara notlar

Bu yöntem Encoding.GetEncoding(String) yöntemi tarafından çağrılır. Bunu doğrudan kullanıcı kodundan çağırmamalısınız.

Uygulayanlara Notlar

Alt sınıfınız tarafından desteklenen kodlamaları veya kodlamaları döndürmek için yöntemini geçersiz kılarsınız GetEncoding(String)EncodingProvider . Kullanıcı kodu yöntemini çağırarak GetEncoding(String) bir kodlama almayı denediğinde, yöntem bağımsız değişkenini name geçerli bir kodlama döndürene kadar her kayıtlı kodlama sağlayıcısına geçirir. Hiçbiri geçerli bir kodlama döndürmezse, GetEncoding(String) yöntemi adı nameolan önbelleğe alınmış bir kodlama almaya çalışır. Bu nedenle, desteklediğiniz bir kodlamanın adı değilse name yöntemi döndürmelidir null. Yönteminin bir özel durum oluşturması gereken tek durum ise name olur null.

Arayanlara Notlar

Bu yöntem yöntemi tarafından çağrılır GetEncoding(String) . Bunu doğrudan kullanıcı kodundan çağırmamalısınız.

Ayrıca bkz.

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Kaynak:

EncodingProvider.cs

Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.

public:
 virtual System::Text::Encoding ^ GetEncoding(int codepage, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding? GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (codepage As Integer, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parametreler

codepage

Int32

İstenen kodlamanın kod sayfası tanımlayıcısı.

encoderFallback

EncoderFallback

Bir karakter bu kodlamayla kodlanamadığında hata işleme yordamı sağlayan nesne.

decoderFallback

DecoderFallback

Bayt dizisinin kodu bu kodlamayla çözülemediğinde hata işleme yordamı sağlayan nesne.

Döndürülenler

Encoding

Belirtilen kod sayfasıyla ilişkili kodlama veya null buna EncodingProvider karşılık gelen codepagegeçerli bir kodlama döndüremiyorsa.

Açıklamalar

encoderFallback ve decoderFallback parametreleri, bir kodlayıcının bir karakteri bayt dizisine dönüştürememesi veya kod çözücü bir bayt dizisini karaktere dönüştürememesi durumunda kullanılan geri dönüş stratejisini tanımlayan nesnelerdir. .NET Framework aşağıdaki geri dönüş mekanizmalarını sağlar:

• Özel durum geri dönüşü. encoderFallback Bağımsız değişken bir örneğiyse EncoderExceptionFallbackveya decoderExceptionFallback bağımsız değişken bir örneğiyseDecoderExceptionFallback, karakterler kodlanamazsa kodlama yöntemi bir özel durum oluşturur ve bayt dizisinin kodu çözülemezse kod çözme yöntemi bir özel durum oluşturur.

• Yedek geri dönüş. encoderFallback Bağımsız değişken bir örneğiyse EncoderReplacementFallbackveya decoderExceptionFallback bağımsız değişken bir örneğiyseDecoderReplacementFallback, kodlama ve kod çözme yöntemleri kodlanamayan karakterlerin yerine bir değiştirme dizesi koyar ve bayt dizilerinin kodu çözülemez. Parametresiz oluşturucuyu çağırarak değiştirme geri dönüş nesnesinin örneğini oluşturmuşsanız, değiştirme karakteri bir "?" olur. veya DecoderReplacementFallback.DecoderReplacementFallback(String) oluşturucuyu EncoderReplacementFallback.EncoderReplacementFallback(String) çağırırsanız, değiştirme dizesini belirtebilirsiniz.

• En uygun geri dönüş. En uygun değiştirme mekanizmasını EncoderFallback uygulamak için veya DecoderFallback sınıfından türetebilirsiniz.

Devralanlara Notlar

Bu yönteme yapılan çağrılar yönteminizin uygulamanızı kullandığından GetEncoding(Int32) , bunu geçersiz kılmanız gerekmez. Kullanıcı kodu yöntemini çağırarak GetEncoding(Int32, EncoderFallback, DecoderFallback) bir kodlama almayı denediğinde, yöntem tanımlayıcıyı codepage geçerli bir kodlama döndürene kadar her kayıtlı kodlama sağlayıcısına geçirir. Hiçbiri geçerli bir kodlama döndürmezse, GetEncoding(Int32) yöntem kod sayfası tanımlayıcısı codepageolan önbelleğe alınmış bir kodlamayı almaya çalışır. Bu nedenle, yöntemini geçersiz kılmayı seçerseniz, geçersiz kılma GetEncoding(Int32, EncoderFallback, DecoderFallback) işleminiz desteklediğiniz bir kodlamanın kod sayfası tanımlayıcısı değilse codepage döndürmelidirnull; hiçbir zaman özel durum oluşturmamalıdır.

Arayanlara Notlar

Bu yöntem yöntemi tarafından çağrılır GetEncoding(Int32, EncoderFallback, DecoderFallback) . Bunu doğrudan kullanıcı kodundan çağırmamalısınız.

Ayrıca bkz.

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Kaynak:

EncodingProvider.cs

Belirtilen adla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.

public:
 virtual System::Text::Encoding ^ GetEncoding(System::String ^ name, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding? GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (name As String, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Parametreler

name

String

Tercih edilen kodlamanın adı.

encoderFallback

EncoderFallback

Bir karakter bu kodlamayla kodlanamadığında hata işleme yordamı sağlayan nesne.

decoderFallback

DecoderFallback

Bayt dizisinin kodu geçerli kodlamayla çözülemediğinde hata işleme yordamı sağlayan nesne.

Döndürülenler

Encoding

Belirtilen adla ilişkili kodlama veya null buna EncodingProvider karşılık gelen namegeçerli bir kodlama döndüremiyorsa.

Açıklamalar

encoderFallback ve decoderFallback parametreleri, bir kodlayıcının bir karakteri bayt dizisine dönüştürememesi veya kod çözücü bir bayt dizisini karaktere dönüştürememesi durumunda kullanılan geri dönüş stratejisini tanımlayan nesnelerdir. .NET Framework aşağıdaki geri dönüş mekanizmalarını sağlar:

• Özel durum geri dönüşü. encoderFallback Bağımsız değişken bir örneğiyse EncoderExceptionFallbackveya decoderExceptionFallback bağımsız değişken bir örneğiyseDecoderExceptionFallback, karakterler kodlanamazsa kodlama yöntemi bir özel durum oluşturur ve bayt dizisinin kodu çözülemezse kod çözme yöntemi bir özel durum oluşturur.

• Yedek geri dönüş. encoderFallback Bağımsız değişken bir örneğiyse EncoderReplacementFallbackveya decoderExceptionFallback bağımsız değişken bir örneğiyseDecoderReplacementFallback, kodlama ve kod çözme yöntemleri kodlanamayan karakterlerin yerine bir değiştirme dizesi koyar ve bayt dizilerinin kodu çözülemez. Parametresiz oluşturucuyu çağırarak değiştirme geri dönüş nesnesinin örneğini oluşturmuşsanız, değiştirme karakteri bir "?" olur. veya DecoderReplacementFallback.DecoderReplacementFallback(String) oluşturucuyu EncoderReplacementFallback.EncoderReplacementFallback(String) çağırırsanız, değiştirme dizesini belirtebilirsiniz.

• En uygun geri dönüş. En uygun değiştirme mekanizmasını EncoderFallback uygulamak için veya DecoderFallback sınıfından türetebilirsiniz.

Devralanlara Notlar

Bu yönteme yapılan çağrılar yönteminizin uygulamanızı kullandığından GetEncoding(String) , bunu geçersiz kılmanız gerekmez. Kullanıcı kodu yöntemini çağırarak GetEncoding(String, EncoderFallback, DecoderFallback) bir kodlama almayı denediğinde, yöntem tanımlayıcıyı codepage geçerli bir kodlama döndürene kadar her kayıtlı kodlama sağlayıcısına geçirir. Hiçbiri geçerli bir kodlama döndürmezse, GetEncoding(Int32) yöntem kod sayfası tanımlayıcısı codepageolan önbelleğe alınmış bir kodlamayı almaya çalışır. Bu nedenle, yöntemini geçersiz kılmayı seçerseniz, geçersiz kılma GetEncoding(Int32, EncoderFallback, DecoderFallback) işleminiz desteklediğiniz bir kodlamanın kod sayfası tanımlayıcısı değilse codepage döndürmelidirnull; hiçbir zaman özel durum oluşturmamalıdır.

Arayanlara Notlar

Bu yöntem yöntemi tarafından çağrılır GetEncoding(String, EncoderFallback, DecoderFallback) . Bunu doğrudan kullanıcı kodundan çağırmamalısınız.

Ayrıca bkz.

• GetEncoding(String, EncoderFallback, DecoderFallback)