Udostępnij za pośrednictwem


EncodingProvider.GetEncoding Metoda

Definicja

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
Źródło:
EncodingProvider.cs
Ź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);
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

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ż

Dotyczy

GetEncoding(String)

Źródło:
EncodingProvider.cs
Źródło:
EncodingProvider.cs
Ź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);
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

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ż

Dotyczy

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Źródło:
EncodingProvider.cs
Źródło:
EncodingProvider.cs
Ź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);
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

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:

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ż

Dotyczy

GetEncoding(String, EncoderFallback, DecoderFallback)

Źródło:
EncodingProvider.cs
Źródło:
EncodingProvider.cs
Ź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);
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

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:

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ż

Dotyczy