SecureString.InsertAt(Int32, Char) Methode

Definition

Namespace:

System.Security

Assembly:

mscorlib.dll

Fügt ein Zeichen in diese sichere Zeichenfolge an der angegebenen Indexposition ein.

public:
 void InsertAt(int index, char c);

[System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions]
public void InsertAt(int index, char c);

[<System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions>]
member this.InsertAt : int * char -> unit

Public Sub InsertAt (index As Integer, c As Char)

Parameter

index

Int32

Die Indexposition, an der der Parameter c eingefügt wird.

c

Char

Das einzufügende Zeichen.

Attribute

HandleProcessCorruptedStateExceptionsAttribute

Ausnahmen

ObjectDisposedException

Diese sichere Zeichenfolge wurde bereits verworfen.

InvalidOperationException

Diese sichere Zeichenfolge ist schreibgeschützt.

ArgumentOutOfRangeException

index ist kleiner als Null oder größer als die Länge dieser sicheren Zeichenfolge.

-oder-

Durch ausführen dieses Vorgangs würde die Länge dieser sicheren Zeichenfolge größer als 65.536 Zeichen sein.

CryptographicException

Fehler beim Schützen oder Aufheben des Schutzes des Werts dieser sicheren Zeichenfolge.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sich die AppendCharMethoden , , InsertAt, RemoveAtSetAtund Clear die Methoden auf den Wert eines SecureString Objekts auswirken.

using System;
using System.Security;

class SecureStringExample
{
    public static void Main()
    {
       string msg = "The current length of the SecureString object: {0}\n";
       Console.WriteLine("1) Instantiate the SecureString object.");
       SecureString ss = new SecureString();
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("2) Append 'a' to the value.");
       ss.AppendChar('a');
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("3) Append 'X' to the value.");
       ss.AppendChar('X');
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("4) Append 'c' to the value.");
       ss.AppendChar('c');
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("5) Insert 'd' at the end of the value.");
       ss.InsertAt(ss.Length, 'd');
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("6) Remove the last character ('d') from the value.");
       ss.RemoveAt(3);
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("7) Set the second character of the value to 'b'.");
       ss.SetAt(1, 'b');
       Console.WriteLine(msg, ss.Length);

       Console.WriteLine("8) Delete the value of the SecureString object:");
       ss.Clear();
       Console.WriteLine(msg, ss.Length);

       ss.Dispose();
    }
}
// The example displays the following output:
//       1) Instantiate the SecureString object.
//       The current length of the SecureString object: 0
//
//       2) Append 'a' to the value.
//       The current length of the SecureString object: 1
//
//       3) Append 'X' to the value.
//       The current length of the SecureString object: 2
//
//       4) Append 'c' to the value.
//       The current length of the SecureString object: 3
//
//       5) Insert 'd' at the end of the value.
//       The current length of the SecureString object: 4
//
//       6) Remove the last character ('d') from the value.
//       The current length of the SecureString object: 3
//
//       7) Set the second character of the value to 'b'.
//       The current length of the SecureString object: 3
//
//       8) Delete the value of the SecureString object:
//       The current length of the SecureString object: 0

Imports System.Security

Module Example
    Public Sub Main()
       Dim msg As String = "The current length of the SecureString object: {0}" + vbCrLf
       Console.WriteLine("1) Instantiate the SecureString object.")
       Dim ss As New SecureString()
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("2) Append 'a' to the value.")
       ss.AppendChar("a"c)
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("3) Append 'X' to the value.")
       ss.AppendChar("X"c)
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("4) Append 'c' to the value.")
       ss.AppendChar("c"c)
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("5) Insert 'd' at the end of the value.")
       ss.InsertAt(ss.Length, "d"c)
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("6) Remove the last character ('d') from the value.")
       ss.RemoveAt(3)
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("7) Set the second character of the value to 'b'.")
       ss.SetAt(1, "b"c)
       Console.WriteLine(msg, ss.Length)

       Console.WriteLine("8) Delete the value of the SecureString object:")
       ss.Clear()
       Console.WriteLine(msg, ss.Length)

       ss.Dispose()
    End Sub
End Module
' The example displays the following output:
'       1) Instantiate the SecureString object.
'       The current length of the SecureString object: 0
'
'       2) Append 'a' to the value.
'       The current length of the SecureString object: 1
'
'       3) Append 'X' to the value.
'       The current length of the SecureString object: 2
'
'       4) Append 'c' to the value.
'       The current length of the SecureString object: 3
'
'       5) Insert 'd' at the end of the value.
'       The current length of the SecureString object: 4
'
'       6) Remove the last character ('d') from the value.
'       The current length of the SecureString object: 3
'
'       7) Set the second character of the value to 'b'.
'       The current length of the SecureString object: 3
'
'       8) Delete the value of the SecureString object:
'       The current length of the SecureString object: 0

Hinweise

Der Index ist nullbasiert; Das erste Zeichen in dieser sicheren Zeichenfolge befindet sich an der Indexposition 0.

Wenn die Implementierung einen Schutzmechanismus verwendet, z. B. Verschlüsselung, ist der Wert der sicheren Zeichenfolge (sofern vorhanden) nicht geschützt; c wird an der angegebenen Indexposition eingefügt. Anschließend wird der neue Wert erneut geschützt. Die InsertAt Methode liefert die gleichen Ergebnisse wie die AppendChar Methode, die am Ende einer sicheren Zeichenfolge ein Zeichen einfügt, wenn der index Parameter InsertAt auf die Länge dieser Instanz festgelegt ist.