Udostępnij za pośrednictwem


UTF7Encoding Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy UTF7Encoding.

Przeciążenia

UTF7Encoding()
Przestarzałe.

Inicjuje nowe wystąpienie klasy UTF7Encoding.

UTF7Encoding(Boolean)
Przestarzałe.

Inicjuje nowe wystąpienie klasy UTF7Encoding. Parametr określa, czy zezwalać na znaki opcjonalne.

UTF7Encoding()

Źródło:
UTF7Encoding.cs
Źródło:
UTF7Encoding.cs
Źródło:
UTF7Encoding.cs

Przestroga

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

Inicjuje nowe wystąpienie klasy UTF7Encoding.

public:
 UTF7Encoding();
public UTF7Encoding ();
[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding ();
Public Sub New ()
Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć nowe UTF7Encoding wystąpienie i wyświetlić nazwę kodowania.

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

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

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim encodingName As String = utf7.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

Uwagi

Ten konstruktor tworzy wystąpienie, które nie zezwala na znaki opcjonalne. Wywoływanie konstruktora UTF7Encoding jest równoważne wywołaniu konstruktora UTF7Encoding.UTF7Encoding(Boolean) , który przyjmuje allowOptionals parametr i określa false dla tego parametru.

Jeśli wystąpienie zezwala na znaki opcjonalne, punkty kodu Unicode są kodowane z odpowiednim opcjonalnym znakiem zamiast zmodyfikowanego znaku base 64. Znaki opcjonalne to wykrzyknik ("!"), ukośnik odwrotny ("\"), pionowy wiersz ("|"), podwójny cudzysłów ("""), znak liczbowy ("#"), znak dolara ("$"), znak procentu ("%"), znak procentu ("%"), znak ampersand ("&"), gwiazdka ("*"), średnik (";"), lewo nawias kątowy ("<"), prawy nawias kwadratowy (">"), lewy nawias klamrowy ("{"), lewy nawias kwadratowy ("["), prawy nawias kwadratowy ("]"), znak równości ("="), znak równości ("@"), akcent circumflex ("^"), podkreślenie ("_") i akcent grobowy ("").

Uwaga

UTF7Encoding nie zapewnia wykrywania błędów. Ze względów bezpieczeństwa zaleca się korzystanie z UTF8Encodingaplikacji , UnicodeEncodinglub UTF32Encoding i włączanie wykrywania błędów.

Dotyczy

UTF7Encoding(Boolean)

Źródło:
UTF7Encoding.cs
Źródło:
UTF7Encoding.cs
Źródło:
UTF7Encoding.cs

Przestroga

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

Inicjuje nowe wystąpienie klasy UTF7Encoding. Parametr określa, czy zezwalać na znaki opcjonalne.

public:
 UTF7Encoding(bool allowOptionals);
public UTF7Encoding (bool allowOptionals);
[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding (bool allowOptionals);
new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding
[<System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding
Public Sub New (allowOptionals As Boolean)

Parametry

allowOptionals
Boolean

true aby określić, że znaki opcjonalne są dozwolone; w przeciwnym razie , false.

Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć nowe UTF7Encoding wystąpienie, które zezwala na znaki opcjonalne.

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()
{
   
   // A few optional characters.
   String^ chars = "!@#$";
   
   // The default Encoding does not allow optional characters.
   // Alternate Byte values are used.
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   array<Byte>^bytes1 = utf7->GetBytes( chars );
   Console::WriteLine( "Default UTF7 Encoding:" );
   ShowArray( bytes1 );
   
   // Convert back to characters.
   Console::WriteLine( "Characters:" );
   ShowArray( utf7->GetChars( bytes1 ) );
   
   // Now, allow optional characters.
   // Optional characters are encoded with their normal code points.
   UTF7Encoding^ utf7AllowOptionals = gcnew UTF7Encoding( true );
   array<Byte>^bytes2 = utf7AllowOptionals->GetBytes( chars );
   Console::WriteLine( "UTF7 Encoding with optional characters allowed:" );
   ShowArray( bytes2 );
   
   // Convert back to characters.
   Console::WriteLine( "Characters:" );
   ShowArray( utf7AllowOptionals->GetChars( bytes2 ) );
}
using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {

        // A few optional characters.
        string chars = "!@#$";

        // The default Encoding does not allow optional characters.
        // Alternate byte values are used.
        UTF7Encoding utf7 = new UTF7Encoding();
        Byte[] bytes1 = utf7.GetBytes(chars);
        
        Console.WriteLine("Default UTF7 Encoding:");
        ShowArray(bytes1);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7.GetChars(bytes1));

        // Now, allow optional characters.
        // Optional characters are encoded with their normal code points.
        UTF7Encoding utf7AllowOptionals = new UTF7Encoding(true);
        Byte[] bytes2 = utf7AllowOptionals.GetBytes(chars);
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:");
        ShowArray(bytes2);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7AllowOptionals.GetChars(bytes2));
    }

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

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        
        ' A few optional characters.
        Dim chars As String = "!@#$"
        
        ' The default Encoding does not allow optional characters.
        ' Alternate byte values are used.
        Dim utf7 As New UTF7Encoding()
        Dim bytes1 As Byte() = utf7.GetBytes(chars)
        
        Console.WriteLine("Default UTF7 Encoding:")
        ShowArray(bytes1)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7.GetChars(bytes1))
        
        ' Now, allow optional characters.
        ' Optional characters are encoded with their normal code points.
        Dim utf7AllowOptionals As New UTF7Encoding(True)
        Dim bytes2 As Byte() = utf7AllowOptionals.GetBytes(chars)
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:")
        ShowArray(bytes2)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7AllowOptionals.GetChars(bytes2))
    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

Uwagi

Jeśli wystąpienie zezwala na znaki opcjonalne, punkty kodu Unicode są kodowane z odpowiednim opcjonalnym znakiem zamiast zmodyfikowanego znaku base 64. Znaki opcjonalne to wykrzyknik ("!"), ukośnik odwrotny ("\"), pionowy wiersz ("|"), podwójny cudzysłów ("""), znak liczbowy ("#"), znak dolara ("$"), znak procentu ("%"), znak procentu ("%"), znak ampersand ("&"), gwiazdka ("*"), średnik (";"), lewo nawias kątowy ("<"), prawy nawias kwadratowy (">"), lewy nawias klamrowy ("{"), lewy nawias kwadratowy ("["), prawy nawias kwadratowy ("]"), znak równości ("="), znak równości ("@"), akcent circumflex ("^"), podkreślenie ("_") i akcent grobowy ("").

Uwaga

UTF7Encoding nie zapewnia wykrywania błędów. Ze względów bezpieczeństwa zaleca się korzystanie z UTF8Encodingaplikacji , UnicodeEncodinglub UTF32Encoding i włączanie wykrywania błędów.

Dotyczy