EncodingProvider.GetEncoding Метод

Определение

Пространство имен:

System.Text

Сборки:

netstandard.dll, System.Runtime.dll

Возвращает кодировку.

Перегрузки

Имя	Описание
GetEncoding(Int32)	Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.
GetEncoding(String)	Возвращает кодировку с указанным именем.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Возвращает кодировку, связанную с указанным идентификатором кодовой страницы. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы.
GetEncoding(String, EncoderFallback, DecoderFallback)	Возвращает кодировку, связанную с указанным именем. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы.

GetEncoding(Int32)

Исходный код:

EncodingProvider.cs

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.

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

Параметры

codepage

Int32

Идентификатор кодовой страницы запрошенной кодировки.

Возвращаемое значение

Encoding

Кодировка, связанная с указанной кодовой страницей, или null если это EncodingProvider не может возвращать допустимую кодировку, соответствующую codepage.

Комментарии

Примечания для звонивших

Этот метод вызывается методом Encoding.GetEncoding(Int32). Не следует вызывать его непосредственно из пользовательского кода.

Примечания для тех, кто реализует этот метод

Метод переопределяется GetEncoding(Int32) для возврата кодировки или кодирования, поддерживаемых подклассом EncodingProvider . Когда пользовательский код пытается получить кодировку путем вызова GetEncoding(Int32) метода, метод передает codepage идентификатор каждому зарегистрированном поставщику кодирования, пока не возвращается допустимая кодировка. Если ни один из них не возвращает допустимую кодировку, метод пытается получить кэшированную кодировку, GetEncoding(Int32) идентификатор кодовой страницы которой равен codepage. Из-за этого, если codepage кодовая страница не является идентификатором поддерживаемой кодировки, метод должен возвращать null; он никогда не должен вызывать исключение.

Примечания для тех, кто вызывает этот метод

Этот метод вызывается методом GetEncoding(Int32) . Не следует вызывать его непосредственно из пользовательского кода.

См. также раздел

• GetEncoding(Int32)

GetEncoding(String)

Исходный код:

EncodingProvider.cs

Возвращает кодировку с указанным именем.

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

Параметры

name

String

Имя запрошенной кодировки.

Возвращаемое значение

Encoding

Кодировка, связанная с указанным именем, или null если это EncodingProvider не может возвращать допустимую кодировку, соответствующую name.

Комментарии

Примечания к наследуемым

Метод GetEncoding(String) переопределяется для возврата кодировки или кодирования, поддерживаемых подклассом EncodingProvider . Когда пользовательский код пытается получить кодировку путем вызова метода GetEncoding(String), метод передает name аргумент каждому зарегистрированном поставщику кодировки, пока не возвращается допустимая кодировка. Если ни один из них не возвращает допустимую кодировку, метод GetEncoding(String) пытается получить кэшированную кодировку, имя которой имеется name. Из-за этого, если name не имя поддерживаемой кодировки, метод должен возвращать null. Единственным случаем, в котором метод должен вызывать исключение, является, если name это null.

Примечания для звонивших

Этот метод вызывается методом Encoding.GetEncoding(String). Не следует вызывать его непосредственно из пользовательского кода.

Примечания для тех, кто реализует этот метод

Метод переопределяется GetEncoding(String) для возврата кодировки или кодирования, поддерживаемых подклассом EncodingProvider . Когда пользовательский код пытается получить кодировку путем вызова GetEncoding(String) метода, метод передает name аргумент каждому зарегистрированный поставщику кодирования, пока не возвращается допустимое кодирование. Если ни один из них не возвращает допустимую кодировку, метод пытается получить кэшированную кодировку, GetEncoding(String) имя которой имеется name. Из-за этого, если name не имя поддерживаемой кодировки, метод должен возвращать null. Единственным случаем, в котором метод должен вызывать исключение, является, если name это null.

Примечания для тех, кто вызывает этот метод

Этот метод вызывается методом GetEncoding(String) . Не следует вызывать его непосредственно из пользовательского кода.

См. также раздел

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Исходный код:

EncodingProvider.cs

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы.

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

Параметры

codepage

Int32

Идентификатор кодовой страницы запрошенной кодировки.

encoderFallback

EncoderFallback

Объект, предоставляющий процедуру обработки ошибок, если символ не может быть закодирован с помощью этой кодировки.

decoderFallback

DecoderFallback

Объект, предоставляющий процедуру обработки ошибок, когда последовательность байтов не может быть декодирована с помощью этой кодировки.

Возвращаемое значение

Encoding

Кодировка, связанная с указанной кодовой страницей, или null если это EncodingProvider не может возвращать допустимую кодировку, соответствующую codepage.

Комментарии

encoderFallback И decoderFallback параметры — это объекты, определяющие резервную стратегию, используемую в случае, если кодировщик не может преобразовать символ в последовательность байтов или декодировщик не может преобразовать последовательность байтов в символ. Платформа .NET предоставляет следующие резервные механизмы:

• Резервный вариант исключения. encoderFallback Если аргумент является экземпляром или EncoderExceptionFallback аргументом является экземпляромdecoderExceptionFallbackDecoderExceptionFallback, метод кодирования создает исключение, если символы не могут быть закодированы, а метод декодирования создает исключение, если не удается декодировать последовательность байтов.

• Резервный вариант замены. encoderFallback Если аргумент является экземпляром или EncoderReplacementFallback аргументом является экземпляромdecoderExceptionFallbackDecoderReplacementFallback, методы кодирования и декодирования заменяют строку замены символов, которые не могут быть закодированы и последовательности байтов не могут быть декодированы. Если вы создаете экземпляр резервного объекта замены путем вызова конструктора без параметров, символ замены — "?". При вызове или EncoderReplacementFallback.EncoderReplacementFallback(String) конструкторе DecoderReplacementFallback.DecoderReplacementFallback(String) можно указать строку замены.

• Лучший резервный вариант. Вы можете наследовать от EncoderFallback класса или DecoderFallback реализовать оптимальный механизм замены.

Примечания для тех, кто наследует этот метод

Так как вызовы этого метода используют реализацию GetEncoding(Int32) метода, ее не нужно переопределять. Когда пользовательский код пытается получить кодировку путем вызова GetEncoding(Int32, EncoderFallback, DecoderFallback) метода, метод передает codepage идентификатор каждому зарегистрированном поставщику кодирования, пока не возвращается допустимая кодировка. Если ни один из них не возвращает допустимую кодировку, метод пытается получить кэшированную кодировку, GetEncoding(Int32) идентификатор кодовой страницы которой равен codepage. Из-за этого, если вы решили переопределить GetEncoding(Int32, EncoderFallback, DecoderFallback) метод, переопределение должно возвращать null , если codepage не идентификатор кодовой страницы поддерживаемой кодировки; он никогда не должен вызывать исключение.

Примечания для тех, кто вызывает этот метод

Этот метод вызывается методом GetEncoding(Int32, EncoderFallback, DecoderFallback) . Не следует вызывать его непосредственно из пользовательского кода.

См. также раздел

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Исходный код:

EncodingProvider.cs

Возвращает кодировку, связанную с указанным именем. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы.

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

Параметры

name

String

Имя предпочтительной кодировки.

encoderFallback

EncoderFallback

Объект, предоставляющий процедуру обработки ошибок, если символ не может быть закодирован с помощью этой кодировки.

decoderFallback

DecoderFallback

Объект, предоставляющий процедуру обработки ошибок, когда последовательность байтов не может быть декодирована с помощью текущей кодировки.

Возвращаемое значение

Encoding

Кодировка, связанная с указанным именем, или null если это EncodingProvider не может возвращать допустимую кодировку, соответствующую name.

Комментарии

encoderFallback И decoderFallback параметры — это объекты, определяющие резервную стратегию, используемую в случае, если кодировщик не может преобразовать символ в последовательность байтов или декодировщик не может преобразовать последовательность байтов в символ. .NET предоставляет следующие резервные механизмы:

• Резервный вариант исключения. encoderFallback Если аргумент является экземпляром или EncoderExceptionFallback аргументом является экземпляромdecoderExceptionFallbackDecoderExceptionFallback, метод кодирования создает исключение, если символы не могут быть закодированы, а метод декодирования создает исключение, если не удается декодировать последовательность байтов.

• Резервный вариант замены. encoderFallback Если аргумент является экземпляром или EncoderReplacementFallback аргументом является экземпляромdecoderExceptionFallbackDecoderReplacementFallback, методы кодирования и декодирования заменяют строку замены символов, которые не могут быть закодированы и последовательности байтов не могут быть декодированы. Если вы создаете экземпляр резервного объекта замены путем вызова конструктора без параметров, символ замены — "?". При вызове или EncoderReplacementFallback.EncoderReplacementFallback(String) конструкторе DecoderReplacementFallback.DecoderReplacementFallback(String) можно указать строку замены.

• Лучший резервный вариант. Вы можете наследовать от EncoderFallback класса или DecoderFallback реализовать оптимальный механизм замены.

Примечания для тех, кто вызывает этот метод

Этот метод вызывается методом GetEncoding(String, EncoderFallback, DecoderFallback) . Не следует вызывать его непосредственно из пользовательского кода.

См. также раздел

• GetEncoding(String, EncoderFallback, DecoderFallback)