EncodingProvider.GetEncoding Metoda

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

System.Runtime.dll

Zwraca kodowanie.

Przeciążenia

GetEncoding(Int32)	Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej.
GetEncoding(String)	Zwraca kodowanie z określoną nazwą.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.
GetEncoding(String, EncoderFallback, DecoderFallback)	Zwraca kodowanie skojarzone z określoną nazwą. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.

GetEncoding(Int32)

Źródło:

EncodingProvider.cs

Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej.

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

Parametry

codepage

Int32

Identyfikator strony kodowej żądanego kodowania.

Zwraca

Encoding

Kodowanie skojarzone z określoną stroną kodową lub null jeśli nie EncodingProvider może zwrócić prawidłowego kodowania odpowiadającego metodzie codepage.

Uwagi

Uwagi do rozmówców

Ta metoda jest wywoływana przez metodę Encoding.GetEncoding(Int32). Nie należy wywoływać go bezpośrednio z kodu użytkownika.

Uwagi dotyczące implementowania

Należy zastąpić metodę GetEncoding(Int32) , aby zwrócić kodowanie lub kodowanie obsługiwane przez podklasę EncodingProvider . Gdy kod użytkownika próbuje pobrać kodowanie przez wywołanie GetEncoding(Int32) metody , metoda przekazuje codepage identyfikator każdemu zarejestrowanemu dostawcy kodowania, dopóki nie zwróci prawidłowego kodowania. Jeśli żaden z nich nie zwraca prawidłowego kodowania, GetEncoding(Int32) metoda próbuje pobrać kodowanie buforowane, którego identyfikator strony kodowej to codepage. W związku z tym, jeśli codepage nie jest identyfikatorem strony kodowej obsługiwanego przez Ciebie kodowania, metoda powinna zwrócić wartość null; nigdy nie powinna zgłaszać wyjątku.

Uwagi dotyczące wywoływania

Ta metoda jest wywoływana przez metodę GetEncoding(Int32) . Nie należy wywoływać go bezpośrednio z kodu użytkownika.

Zobacz też

• GetEncoding(Int32)

GetEncoding(String)

Źródło:

EncodingProvider.cs

Zwraca kodowanie z określoną nazwą.

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

Parametry

name

String

Nazwa żądanego kodowania.

Zwraca

Encoding

Kodowanie skojarzone z określoną nazwą lub null jeśli nie EncodingProvider może zwrócić prawidłowego kodowania odpowiadającego .name

Uwagi

Uwagi do dziedziczy

Zastąpisz metodę GetEncoding(String), aby zwrócić kodowanie lub kodowanie obsługiwane przez podklasę EncodingProvider . Gdy kod użytkownika próbuje pobrać kodowanie przez wywołanie metody GetEncoding(String), metoda przekazuje name argument do każdego zarejestrowanego dostawcy kodowania, dopóki nie zwróci prawidłowego kodowania. Jeśli żaden z nich nie zwraca prawidłowego kodowania, metoda GetEncoding(String) próbuje pobrać kodowanie buforowane, którego nazwa to name. W związku z tym, jeśli name nie jest nazwą obsługiwanego kodowania, metoda powinna zwrócić wartość null. Jedynym przypadkiem, w którym metoda powinna zgłosić wyjątek, jest , jeśli name jest .null

Uwagi do rozmówców

Ta metoda jest wywoływana przez metodę Encoding.GetEncoding(String). Nie należy wywoływać go bezpośrednio z kodu użytkownika.

Uwagi dotyczące implementowania

Należy zastąpić metodę GetEncoding(String) , aby zwrócić kodowanie lub kodowanie obsługiwane przez podklasę EncodingProvider . Gdy kod użytkownika próbuje pobrać kodowanie przez wywołanie GetEncoding(String) metody , metoda przekazuje name argument do każdego zarejestrowanego dostawcy kodowania, dopóki nie zwróci prawidłowego kodowania. Jeśli żaden z nich nie zwraca prawidłowego kodowania, GetEncoding(String) metoda próbuje pobrać kodowanie buforowane, którego nazwa to name. W związku z tym, jeśli name nie jest nazwą obsługiwanego kodowania, metoda powinna zwrócić wartość null. Jedynym przypadkiem, w którym metoda powinna zgłosić wyjątek, jest , jeśli name jest .null

Uwagi dotyczące wywoływania

Ta metoda jest wywoływana przez metodę GetEncoding(String) . Nie należy wywoływać go bezpośrednio z kodu użytkownika.

Zobacz też

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Źródło:

EncodingProvider.cs

Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.

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

Parametry

codepage

Int32

Identyfikator strony kodowej żądanego kodowania.

encoderFallback

EncoderFallback

Obiekt, który zapewnia procedurę obsługi błędów, gdy nie można zakodować znaku za pomocą tego kodowania.

decoderFallback

DecoderFallback

Obiekt, który zapewnia procedurę obsługi błędów, gdy nie można zdekodować sekwencji bajtów przy użyciu tego kodowania.

Zwraca

Encoding

Kodowanie skojarzone z określoną stroną kodową lub null jeśli nie EncodingProvider może zwrócić prawidłowego kodowania odpowiadającego metodzie codepage.

Uwagi

Parametry encoderFallback i decoderFallback to obiekty definiujące strategię rezerwową używaną w przypadku, gdy koder nie może przekonwertować znaku na sekwencję bajtów lub dekoder nie może przekonwertować sekwencji bajtów na znak. .NET Framework zapewnia następujące mechanizmy rezerwowe:

• Rezerwowy wyjątek. encoderFallback Jeśli argument jest wystąpieniem klasy lub decoderExceptionFallback argument jest wystąpieniem EncoderExceptionFallbackDecoderExceptionFallbackklasy , metoda kodowania zgłasza wyjątek, jeśli nie można kodować znaków, a metoda dekodowania zgłasza wyjątek, jeśli nie można zdekodować sekwencji bajtów.

• Rezerwowa zamiana. encoderFallback Jeśli argument jest wystąpieniem EncoderReplacementFallbackklasy lub decoderExceptionFallback argument jest wystąpieniem DecoderReplacementFallbackklasy , metody kodowania i dekodowania zastępują ciąg zastępczy znaków, których nie można kodować, a sekwencje bajtów nie mogą być dekodowane. Jeśli utworzono wystąpienie zastępczego obiektu rezerwowego przez wywołanie konstruktora bez parametrów, znak zastępczy to "?". W przypadku wywołania konstruktora EncoderReplacementFallback.EncoderReplacementFallback(String) lub DecoderReplacementFallback.DecoderReplacementFallback(String) można określić ciąg zastępczy.

• Najlepiej pasuje rezerwowy. Można pochodzić z EncoderFallback klasy lub DecoderFallback , aby zaimplementować mechanizm wymiany najlepiej dopasowany.

Uwagi dotyczące dziedziczenia

Ponieważ wywołania tej metody używają implementacji GetEncoding(Int32) metody , nie trzeba jej przesłaniać. Gdy kod użytkownika próbuje pobrać kodowanie przez wywołanie GetEncoding(Int32, EncoderFallback, DecoderFallback) metody , metoda przekazuje codepage identyfikator każdemu zarejestrowanemu dostawcy kodowania, dopóki nie zwróci prawidłowego kodowania. Jeśli żaden z nich nie zwraca prawidłowego kodowania, GetEncoding(Int32) metoda próbuje pobrać kodowanie buforowane, którego identyfikator strony kodowej to codepage. W związku z tym, jeśli zdecydujesz się zastąpić GetEncoding(Int32, EncoderFallback, DecoderFallback) metodę, przesłonięcia powinny zostać zwrócone null , jeśli codepage nie jest identyfikatorem strony kodowej obsługiwanego przez Ciebie kodowania; nigdy nie powinien zgłaszać wyjątku.

Uwagi dotyczące wywoływania

Ta metoda jest wywoływana przez metodę GetEncoding(Int32, EncoderFallback, DecoderFallback) . Nie należy wywoływać go bezpośrednio z kodu użytkownika.

Zobacz też

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Źródło:

EncodingProvider.cs

Zwraca kodowanie skojarzone z określoną nazwą. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.

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

Parametry

name

String

Nazwa preferowanego kodowania.

encoderFallback

EncoderFallback

Obiekt, który zapewnia procedurę obsługi błędów, gdy nie można zakodować znaku za pomocą tego kodowania.

decoderFallback

DecoderFallback

Obiekt, który zapewnia procedurę obsługi błędów, gdy nie można zdekodować sekwencji bajtów przy użyciu bieżącego kodowania.

Zwraca

Encoding

Kodowanie skojarzone z określoną nazwą lub null jeśli nie EncodingProvider może zwrócić prawidłowego kodowania odpowiadającego .name

Uwagi

Parametry encoderFallback i decoderFallback to obiekty definiujące strategię rezerwową używaną w przypadku, gdy koder nie może przekonwertować znaku na sekwencję bajtów lub dekoder nie może przekonwertować sekwencji bajtów na znak. .NET Framework zapewnia następujące mechanizmy rezerwowe:

• Rezerwowy wyjątek. encoderFallback Jeśli argument jest wystąpieniem klasy lub decoderExceptionFallback argument jest wystąpieniem EncoderExceptionFallbackDecoderExceptionFallbackklasy , metoda kodowania zgłasza wyjątek, jeśli nie można kodować znaków, a metoda dekodowania zgłasza wyjątek, jeśli nie można zdekodować sekwencji bajtów.

• Rezerwowa zamiana. encoderFallback Jeśli argument jest wystąpieniem EncoderReplacementFallbackklasy lub decoderExceptionFallback argument jest wystąpieniem DecoderReplacementFallbackklasy , metody kodowania i dekodowania zastępują ciąg zastępczy znaków, których nie można kodować, a sekwencje bajtów nie mogą być dekodowane. Jeśli utworzono wystąpienie zastępczego obiektu rezerwowego przez wywołanie konstruktora bez parametrów, znak zastępczy to "?". W przypadku wywołania konstruktora EncoderReplacementFallback.EncoderReplacementFallback(String) lub DecoderReplacementFallback.DecoderReplacementFallback(String) można określić ciąg zastępczy.

• Najlepiej pasuje rezerwowy. Można pochodzić z EncoderFallback klasy lub DecoderFallback , aby zaimplementować mechanizm wymiany najlepiej dopasowany.

Uwagi dotyczące dziedziczenia

Ponieważ wywołania tej metody używają implementacji GetEncoding(String) metody , nie trzeba jej przesłaniać. Gdy kod użytkownika próbuje pobrać kodowanie przez wywołanie GetEncoding(String, EncoderFallback, DecoderFallback) metody , metoda przekazuje codepage identyfikator każdemu zarejestrowanemu dostawcy kodowania, dopóki nie zwróci prawidłowego kodowania. Jeśli żaden z nich nie zwraca prawidłowego kodowania, GetEncoding(Int32) metoda próbuje pobrać kodowanie buforowane, którego identyfikator strony kodowej to codepage. W związku z tym, jeśli zdecydujesz się zastąpić GetEncoding(Int32, EncoderFallback, DecoderFallback) metodę, przesłonięcia powinny zostać zwrócone null , jeśli codepage nie jest identyfikatorem strony kodowej obsługiwanego przez Ciebie kodowania; nigdy nie powinien zgłaszać wyjątku.

Uwagi dotyczące wywoływania

Ta metoda jest wywoływana przez metodę GetEncoding(String, EncoderFallback, DecoderFallback) . Nie należy wywoływać go bezpośrednio z kodu użytkownika.

Zobacz też

• GetEncoding(String, EncoderFallback, DecoderFallback)