UTF8Encoding UTF8Encoding UTF8Encoding UTF8Encoding Constructors

Definição

Sobrecargas

UTF8Encoding() UTF8Encoding() UTF8Encoding()

Inicializa uma nova instância da classe UTF8Encoding.Initializes a new instance of the UTF8Encoding class.

UTF8Encoding(Boolean) UTF8Encoding(Boolean) UTF8Encoding(Boolean) UTF8Encoding(Boolean)

Inicializa uma nova instância da classe UTF8Encoding.Initializes a new instance of the UTF8Encoding class. Um parâmetro especifica se deve ser fornecida uma marca de ordem de byte Unicode.A parameter specifies whether to provide a Unicode byte order mark.

UTF8Encoding(Boolean, Boolean) UTF8Encoding(Boolean, Boolean) UTF8Encoding(Boolean, Boolean) UTF8Encoding(Boolean, Boolean)

Inicializa uma nova instância da classe UTF8Encoding.Initializes a new instance of the UTF8Encoding class. Os parâmetros especificam se uma marca de ordem de byte Unicode será fornecida e se uma exceção será gerada quando uma codificação inválida for detectada.Parameters specify whether to provide a Unicode byte order mark and whether to throw an exception when an invalid encoding is detected.

UTF8Encoding() UTF8Encoding() UTF8Encoding()

Inicializa uma nova instância da classe UTF8Encoding.Initializes a new instance of the UTF8Encoding class.

public:
 UTF8Encoding();
public UTF8Encoding ();
Public Sub New ()

Exemplos

O exemplo a seguir cria uma UTF8Encoding nova instância e exibe seu nome.The following example creates a new UTF8Encoding instance and displays its name.

using namespace System;
using namespace System::Text;
int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   String^ encodingName = utf8->EncodingName;
   Console::WriteLine( "Encoding name: {0}", encodingName );
}

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        String encodingName = utf8.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim encodingName As String = utf8.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

Comentários

Esse construtor cria uma instância que não fornece uma marca de ordem de byte Unicode e não lança uma exceção quando uma codificação inválida é detectada.This constructor creates an instance that does not provide a Unicode byte order mark and does not throw an exception when an invalid encoding is detected.

Cuidado

Por motivos de segurança, recomendamos que você habilite a detecção de erros chamando um throwOnInvalidBytes Construtor com um parâmetro e definindo trueseu valor como.For security reasons, we recommend that you enable error detection by calling a constructor with a throwOnInvalidBytes parameter and setting its value to true.

Veja também

UTF8Encoding(Boolean) UTF8Encoding(Boolean) UTF8Encoding(Boolean) UTF8Encoding(Boolean)

Inicializa uma nova instância da classe UTF8Encoding.Initializes a new instance of the UTF8Encoding class. Um parâmetro especifica se deve ser fornecida uma marca de ordem de byte Unicode.A parameter specifies whether to provide a Unicode byte order mark.

public:
 UTF8Encoding(bool encoderShouldEmitUTF8Identifier);
public UTF8Encoding (bool encoderShouldEmitUTF8Identifier);
new System.Text.UTF8Encoding : bool -> System.Text.UTF8Encoding
Public Sub New (encoderShouldEmitUTF8Identifier As Boolean)

Parâmetros

encoderShouldEmitUTF8Identifier
Boolean Boolean Boolean Boolean

true para especificar que o método GetPreamble() retorna uma marca de ordem de byte Unicode, caso contrário, false.true to specify that the GetPreamble() method returns a Unicode byte order mark; otherwise, false.

Exemplos

O exemplo a seguir cria uma UTF8Encoding nova instância e especifica que um prefixo de marca de ordem de byte Unicode deve ser GetPreamble emitido pelo método.The following example creates a new UTF8Encoding instance and specifies that a Unicode byte order mark prefix should be emitted by the GetPreamble method. Em GetPreamble seguida, o método retorna o prefixo de marca de ordem de byte Unicode.The GetPreamble method then returns the Unicode byte order mark prefix.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
void ShowArray( Array^ theArray )
{
   IEnumerator^ myEnum = theArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ o = safe_cast<Object^>(myEnum->Current);
      Console::Write( "[{0}]", o );
   }

   Console::WriteLine();
}

int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   UTF8Encoding^ utf8EmitBOM = gcnew UTF8Encoding( true );
   Console::WriteLine( "utf8 preamble:" );
   ShowArray( utf8->GetPreamble() );
   Console::WriteLine( "utf8EmitBOM:" );
   ShowArray( utf8EmitBOM->GetPreamble() );
}

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        UTF8Encoding utf8EmitBOM = new UTF8Encoding(true);

        Console.WriteLine("utf8 preamble:");
        ShowArray(utf8.GetPreamble());

        Console.WriteLine("utf8EmitBOM:");
        ShowArray(utf8EmitBOM.GetPreamble());
    }

    public static void ShowArray(Array theArray) {
        foreach (Object o in theArray) {
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    }
}
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim utf8EmitBOM As New UTF8Encoding(True)
        
        Console.WriteLine("utf8 preamble:")
        ShowArray(utf8.GetPreamble())
        
        Console.WriteLine("utf8EmitBOM:")
        ShowArray(utf8EmitBOM.GetPreamble())
    End Sub
    
    
    Public Shared Sub ShowArray(theArray As Array)
        Dim o As Object
        For Each o In  theArray
            Console.Write("[{0}]", o)
        Next o
        Console.WriteLine()
    End Sub
End Class

Comentários

Esse construtor cria uma instância que não gera uma exceção quando uma codificação inválida é detectada.This constructor creates an instance that does not throw an exception when an invalid encoding is detected.

Cuidado

Por motivos de segurança, você deve habilitar a detecção de erros chamando um construtor que throwOnInvalidBytes inclui um parâmetro e definindo seu truevalor como.For security reasons, you should enable error detection by calling a constructor that includes a throwOnInvalidBytes parameter and setting its value to true.

O encoderShouldEmitUTF8Identifier parâmetro controla a operação GetPreamble do método.The encoderShouldEmitUTF8Identifier parameter controls the operation of the GetPreamble method. Se true, o método retorna uma matriz de bytes que contém a bom (marca de ordem de byte) Unicode no formato UTF-8.If true, the method returns a byte array containing the Unicode byte order mark (BOM) in UTF-8 format. Se false, ele retorna uma matriz de byte de comprimento zero.If false, it returns a zero-length byte array. No entanto encoderShouldEmitUTF8Identifier , true a configuração para não GetBytes faz com que o método Prefixe a bom no início da matriz de bytes, nem faz GetByteCount com que o método inclua o número de bytes na bom na contagem de bytes.However, setting encoderShouldEmitUTF8Identifier to true does not cause the GetBytes method to prefix the BOM at the beginning of the byte array, nor does it cause the GetByteCount method to include the number of bytes in the BOM in the byte count.

Veja também

UTF8Encoding(Boolean, Boolean) UTF8Encoding(Boolean, Boolean) UTF8Encoding(Boolean, Boolean) UTF8Encoding(Boolean, Boolean)

Inicializa uma nova instância da classe UTF8Encoding.Initializes a new instance of the UTF8Encoding class. Os parâmetros especificam se uma marca de ordem de byte Unicode será fornecida e se uma exceção será gerada quando uma codificação inválida for detectada.Parameters specify whether to provide a Unicode byte order mark and whether to throw an exception when an invalid encoding is detected.

public:
 UTF8Encoding(bool encoderShouldEmitUTF8Identifier, bool throwOnInvalidBytes);
public UTF8Encoding (bool encoderShouldEmitUTF8Identifier, bool throwOnInvalidBytes);
new System.Text.UTF8Encoding : bool * bool -> System.Text.UTF8Encoding
Public Sub New (encoderShouldEmitUTF8Identifier As Boolean, throwOnInvalidBytes As Boolean)

Parâmetros

encoderShouldEmitUTF8Identifier
Boolean Boolean Boolean Boolean

true para especificar que o método GetPreamble() deve retornar uma marca de ordem de byte Unicode; caso contrário, false.true to specify that the GetPreamble() method should return a Unicode byte order mark; otherwise, false.

throwOnInvalidBytes
Boolean Boolean Boolean Boolean

true para gerar uma exceção quando uma codificação inválida é detectada; caso contrário, false.true to throw an exception when an invalid encoding is detected; otherwise, false.

Exemplos

O exemplo a seguir cria uma UTF8Encoding nova instância, especificando que GetPreamble o método não deve emitir um prefixo de marca de ordem de byte Unicode e uma exceção deve ser lançada quando uma codificação inválida é detectada.The following example creates a new UTF8Encoding instance, specifying that the GetPreamble method should not emit a Unicode byte order mark prefix, and an exception should be thrown when an invalid encoding is detected. O comportamento desse construtor é comparado ao construtor padrão UTF8Encoding() , que não gera uma exceção quando uma codificação inválida é detectada.The behavior of this constructor is compared to the default UTF8Encoding() constructor, which does not throw an exception when an invalid encoding is detected. As duas UTF8Encoding instâncias codificam uma matriz de caracteres que contém dois substitutos altos (u + D801 e u + D802) em uma linha, que é uma sequência de caracteres inválida; um substituto alto sempre deve ser seguido por um substituto baixo.The two UTF8Encoding instances encode a character array that contains two high surrogates (U+D801 and U+D802) in a row, which is an invalid character sequence; a high surrogate should always be followed by a low surrogate.

using namespace System;
using namespace System::Text;

void ShowArray(Array^ theArray)
{
   for each (Byte b in theArray) {
      Console::Write( "{0:X2} ", b);
   }
   Console::WriteLine();
}

int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   UTF8Encoding^ utf8ThrowException = gcnew UTF8Encoding(false,true);
   
   // This array contains two high surrogates in a row (\uD801, \uD802).
   array<Char>^chars = {'a','b','c',L'\xD801',L'\xD802','d'};
   
   // The following method call will not throw an exception.
   array<Byte>^bytes = utf8->GetBytes( chars );
   ShowArray( bytes );
   Console::WriteLine();
   
   try {
      
      // The following method call will throw an exception.
      bytes = utf8ThrowException->GetBytes( chars );
   }
   catch (EncoderFallbackException^ e ) {
            Console::WriteLine("{0} exception\nMessage:\n{1}",
                               e->GetType()->Name, e->Message);
   }

}

using System;
using System.Text;

class Example
{
    public static void Main()
    {
        UTF8Encoding utf8 = new UTF8Encoding();
        UTF8Encoding utf8ThrowException = new UTF8Encoding(false, true);

        // Create an array with two high surrogates in a row (\uD801, \uD802).
        Char[] chars = new Char[] {'a', 'b', 'c', '\uD801', '\uD802', 'd'};

        // The following method call will not throw an exception.
        Byte[] bytes = utf8.GetBytes(chars);
        ShowArray(bytes);
        Console.WriteLine();

        try {
            // The following method call will throw an exception.
            bytes = utf8ThrowException.GetBytes(chars);
            ShowArray(bytes);
        }
        catch (EncoderFallbackException e) {
            Console.WriteLine("{0} exception\nMessage:\n{1}",
                              e.GetType().Name, e.Message);
        }
    }

    public static void ShowArray(Array theArray) {
        foreach (Object o in theArray)
            Console.Write("{0:X2} ", o);

        Console.WriteLine();
    }
}
// The example displays the following output:
//    61 62 63 EF BF BD EF BF BD 64
//
//    EncoderFallbackException exception
//    Message:
//    Unable to translate Unicode character \uD801 at index 3 to specified code page.
Imports System.Text

Class Example
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim utf8ThrowException As New UTF8Encoding(False, True)
        
        ' Create an array with two high surrogates in a row (\uD801, \uD802).
        Dim chars() As Char = {"a"c, "b"c, "c"c, ChrW(&hD801), ChrW(&hD802), "d"c}
        
        ' The following method call will not throw an exception.
        Dim bytes As Byte() = utf8.GetBytes(chars)
        ShowArray(bytes)
        Console.WriteLine()
        
        Try
            ' The following method call will throw an exception.
            bytes = utf8ThrowException.GetBytes(chars)
            ShowArray(bytes)
        Catch e As EncoderFallbackException
            Console.WriteLine("{0} exception{2}Message:{2}{1}",
                              e.GetType().Name, e.Message, vbCrLf)
        End Try
    End Sub
    
    
    Public Shared Sub ShowArray(theArray As Array)
        For Each o In theArray
            Console.Write("{0:X2} ", o)
        Next
        Console.WriteLine()
    End Sub
End Class
' The example displays the following output:
'    61 62 63 EF BF BD EF BF BD 64
'
'    EncoderFallbackException exception
'    Message:
'    Unable to translate Unicode character \uD801 at index 3 to specified code page.

Comentários

O encoderShouldEmitUTF8Identifier parâmetro controla a operação GetPreamble do método.The encoderShouldEmitUTF8Identifier parameter controls the operation of the GetPreamble method. Se true, o método retorna uma matriz de bytes que contém a bom (marca de ordem de byte) Unicode no formato UTF-8.If true, the method returns a byte array containing the Unicode byte order mark (BOM) in UTF-8 format. Se false, ele retorna uma matriz de byte de comprimento zero.If false, it returns a zero-length byte array. No entanto encoderShouldEmitUTF8Identifier , true a configuração para não GetBytes faz com que o método Prefixe a bom no início da matriz de bytes, nem faz GetByteCount com que o método inclua o número de bytes na bom na contagem de bytes.However, setting encoderShouldEmitUTF8Identifier to true does not cause the GetBytes method to prefix the BOM at the beginning of the byte array, nor does it cause the GetByteCount method to include the number of bytes in the BOM in the byte count.

Se throwOnInvalidBytes System.ArgumentException for true, um método que detecta uma sequência de bytes inválida gera uma exceção.If throwOnInvalidBytes is true, a method that detects an invalid byte sequence throws an System.ArgumentException exception. Caso contrário, o método não lançará uma exceção e a sequência inválida será ignorada.Otherwise, the method does not throw an exception, and the invalid sequence is ignored.

Cuidado

Por motivos de segurança, você deve habilitar a detecção de erros chamando um construtor que throwOnInvalidBytes inclui um parâmetro e definindo esse trueparâmetro como.For security reasons, you should enable error detection by calling a constructor that includes a throwOnInvalidBytes parameter and setting that parameter to true.

Veja também

Aplica-se a