Freigeben über


UTF7Encoding Konstruktoren

Definition

Initialisiert eine neue Instanz der UTF7Encoding-Klasse.

Überlädt

UTF7Encoding()
Veraltet.

Initialisiert eine neue Instanz der UTF7Encoding-Klasse.

UTF7Encoding(Boolean)
Veraltet.

Initialisiert eine neue Instanz der UTF7Encoding-Klasse. Ein Parameter gibt an, ob optionale Zeichen zulässig sind.

UTF7Encoding()

Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs

Achtung

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

Initialisiert eine neue Instanz der UTF7Encoding-Klasse.

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 ()
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine neue UTF7Encoding instance erstellen und den Namen der Codierung anzeigen.

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

Hinweise

Dieser Konstruktor erstellt eine instance, die keine optionalen Zeichen zulässt. Das Aufrufen des UTF7Encoding Konstruktors entspricht dem Aufrufen des Konstruktors, der UTF7Encoding.UTF7Encoding(Boolean) einen allowOptionals Parameter akzeptiert und für diesen Parameter angibt false .

Wenn ein instance optionale Zeichen zulässt, werden Unicode-Codepunkte mit einem entsprechenden optionalen Zeichen anstelle eines geänderten 64-Zeichens codiert. Optionale Zeichen sind Ausrufezeichen ("!"), Schrägstrich ("\"), vertikale Linie ("|"), doppeltes Anführungszeichen ("#"), Dollarzeichen ("$"), Prozentzeichen ("%"), ampersand ("&"), Sternchen ("*"), Semikolon (";"), links Eckige Klammer ("<"), rechte eckige Klammer (">"), linke geschweifte Klammer ("{"), rechte geschweifte Klammer ("}"), linke eckige Klammer ("["), rechte eckige Klammer ("]"), Gleichheitszeichen ("="), bei Vorzeichen ("@"), circumflex-Akzent ("^"), Unterstrich ("_") und Grabakzent ("'").

Hinweis

UTF7Encoding bietet keine Fehlererkennung. Aus Sicherheitsgründen wird empfohlen, dass Ihre Anwendungen , UnicodeEncodingoder UTF32Encoding verwenden UTF8Encodingund die Fehlererkennung aktivieren.

Gilt für:

UTF7Encoding(Boolean)

Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs

Achtung

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

Initialisiert eine neue Instanz der UTF7Encoding-Klasse. Ein Parameter gibt an, ob optionale Zeichen zulässig sind.

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)

Parameter

allowOptionals
Boolean

true, um anzugeben, dass optionale Zeichen zulässig sind, andernfalls false.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine neue UTF7Encoding instance erstellen, die optionale Zeichen zulässt.

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

Hinweise

Wenn ein instance optionale Zeichen zulässt, werden Unicode-Codepunkte mit einem entsprechenden optionalen Zeichen anstelle eines geänderten 64-Zeichens codiert. Optionale Zeichen sind Ausrufezeichen ("!"), Schrägstrich ("\"), vertikale Linie ("|"), doppeltes Anführungszeichen ("#"), Dollarzeichen ("$"), Prozentzeichen ("%"), ampersand ("&"), Sternchen ("*"), Semikolon (";"), links Eckige Klammer ("<"), rechte eckige Klammer (">"), linke geschweifte Klammer ("{"), rechte geschweifte Klammer ("}"), linke eckige Klammer ("["), rechte eckige Klammer ("]"), Gleichheitszeichen ("="), bei Vorzeichen ("@"), circumflex-Akzent ("^"), Unterstrich ("_") und Grabakzent ("'").

Hinweis

UTF7Encoding bietet keine Fehlererkennung. Aus Sicherheitsgründen wird empfohlen, dass Ihre Anwendungen , UnicodeEncodingoder UTF32Encoding verwenden UTF8Encodingund die Fehlererkennung aktivieren.

Gilt für: