UTF7Encoding Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe UTF7Encoding.
Overload
| Nome | Descrizione |
|---|---|
| UTF7Encoding() |
Obsoleti.
Inizializza una nuova istanza della classe UTF7Encoding. |
| UTF7Encoding(Boolean) |
Obsoleti.
Inizializza una nuova istanza della classe UTF7Encoding. Un parametro specifica se consentire caratteri facoltativi. |
UTF7Encoding()
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
Attenzione
The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.
Inizializza una nuova istanza della classe 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 ()
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato come creare una nuova UTF7Encoding istanza e visualizzare il nome della codifica.
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
Commenti
Questo costruttore crea un'istanza che non consente caratteri facoltativi. La chiamata al UTF7Encoding costruttore equivale a chiamare il UTF7Encoding.UTF7Encoding(Boolean) costruttore che accetta un allowOptionals parametro e specifica per false tale parametro.
Se un'istanza consente caratteri facoltativi, i punti di codice Unicode vengono codificati con un carattere facoltativo corrispondente anziché un carattere di base 64 modificato. I caratteri facoltativi sono punto esclamativo ("!"), barra rovescia ("\"), linea verticale ("|"), virgolette doppie ("""), segno di numero ("#"), segno di dollaro ("$"), segno di percentuale ("%"), e commerciale ("&"), asterisco ("*"), punto e virgola (";"), a sinistra parentesi quadra chiusa ("<"), parentesi quadra chiusa (">"), parentesi graffa sinistra ("{"), parentesi graffa destra ("}"), parentesi quadrata sinistra ("["), parentesi quadrata destra ("]"), segno di uguale ("="), segno di uguale ("@"), accento circonflesso ("^"), sottolineatura ("_"), e accento grave ("'").
Note
UTF7Encoding non fornisce il rilevamento degli errori. Per motivi di sicurezza, le applicazioni sono consigliate per usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.
Si applica a
UTF7Encoding(Boolean)
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
- Origine:
- UTF7Encoding.cs
Attenzione
The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.
Inizializza una nuova istanza della classe UTF7Encoding. Un parametro specifica se consentire caratteri facoltativi.
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)
Parametri
- allowOptionals
- Boolean
true per specificare che i caratteri facoltativi sono consentiti; in caso contrario, false.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato come creare una nuova UTF7Encoding istanza che consenta caratteri facoltativi.
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
Commenti
Se un'istanza consente caratteri facoltativi, i punti di codice Unicode vengono codificati con un carattere facoltativo corrispondente anziché un carattere di base 64 modificato. I caratteri facoltativi sono punto esclamativo ("!"), barra rovescia ("\"), linea verticale ("|"), virgolette doppie ("""), segno di numero ("#"), segno di dollaro ("$"), segno di percentuale ("%"), e commerciale ("&"), asterisco ("*"), punto e virgola (";"), a sinistra parentesi quadra chiusa ("<"), parentesi quadra chiusa (">"), parentesi graffa sinistra ("{"), parentesi graffa destra ("}"), parentesi quadrata sinistra ("["), parentesi quadrata destra ("]"), segno di uguale ("="), segno di uguale ("@"), accento circonflesso ("^"), sottolineatura ("_"), e accento grave ("'").
Note
UTF7Encoding non fornisce il rilevamento degli errori. Per motivi di sicurezza, le applicazioni sono consigliate per usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.