UTF7Encoding Konstruktorer
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av UTF7Encoding klassen.
Överlagringar
| Name | Description |
|---|---|
| UTF7Encoding() |
Föråldrad.
Initierar en ny instans av UTF7Encoding klassen. |
| UTF7Encoding(Boolean) |
Föråldrad.
Initierar en ny instans av UTF7Encoding klassen. En parameter anger om valfria tecken ska tillåtas. |
UTF7Encoding()
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
Varning
The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.
Initierar en ny instans av UTF7Encoding klassen.
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 ()
- Attribut
Exempel
I följande kodexempel visas hur du skapar en ny UTF7Encoding instans och visar namnet på kodningen.
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
Kommentarer
Den här konstruktorn skapar en instans som inte tillåter valfria tecken.
UTF7Encoding Att anropa konstruktorn motsvarar att anropa UTF7Encoding.UTF7Encoding(Boolean) konstruktorn som tar en allowOptionals parameter och ange false för den parametern.
Om en instans tillåter valfria tecken kodas Unicode-kodpunkter med motsvarande valfria tecken i stället för ett ändrat bas 64-tecken. De valfria tecknen är utropstecken ("!"), bakåtsnedstreck ("\"), lodrät linje ("|"), dubbelt citattecken ("""), taltecken ("#"), dollartecken ("$"), procenttecken ("%"), etand ("&"), asterisk ("*"), semikolon (";"), vänster vinkelparentes ("<"), höger vinkelparentes (">"), vänster klammerparentes ("{"), höger klammerparentes ("}"), vänster hakparentes ("["), höger hakparentes ("]"), likhetstecken ("="), vid tecken ("@"), cirkumflex accent ("^"), understreck ("_"), och grav accent ("'").
Note
UTF7Encoding anger inte felidentifiering. Av säkerhetsskäl rekommenderas dina program att använda UTF8Encoding, UnicodeEncodingeller UTF32Encoding och aktivera felidentifiering.
Gäller för
UTF7Encoding(Boolean)
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
- Källa:
- UTF7Encoding.cs
Varning
The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.
Initierar en ny instans av UTF7Encoding klassen. En parameter anger om valfria tecken ska tillåtas.
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)
Parametrar
- allowOptionals
- Boolean
trueför att ange att valfria tecken tillåts. annars . false
- Attribut
Exempel
I följande kodexempel visas hur du skapar en ny UTF7Encoding instans som tillåter valfria tecken.
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
Kommentarer
Om en instans tillåter valfria tecken kodas Unicode-kodpunkter med motsvarande valfria tecken i stället för ett ändrat bas 64-tecken. De valfria tecknen är utropstecken ("!"), bakåtsnedstreck ("\"), lodrät linje ("|"), dubbelt citattecken ("""), taltecken ("#"), dollartecken ("$"), procenttecken ("%"), etand ("&"), asterisk ("*"), semikolon (";"), vänster vinkelparentes ("<"), höger vinkelparentes (">"), vänster klammerparentes ("{"), höger klammerparentes ("}"), vänster hakparentes ("["), höger hakparentes ("]"), likhetstecken ("="), vid tecken ("@"), cirkumflex accent ("^"), understreck ("_"), och grav accent ("'").
Note
UTF7Encoding anger inte felidentifiering. Av säkerhetsskäl rekommenderas dina program att använda UTF8Encoding, UnicodeEncodingeller UTF32Encoding och aktivera felidentifiering.