SecureString.InsertAt(Int32, Char) Metoda

Definice

Obor názvů:

System.Security

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Zdroj:

SecureString.cs

Vloží znak do tohoto zabezpečeného řetězce na zadanou pozici indexu.

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

public void InsertAt(int index, char c);

member this.InsertAt : int * char -> unit

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

Parametry

index

Int32

Pozice indexu, do které je vložen parametr c .

c

Char

Znak, který chcete vložit.

Výjimky

ObjectDisposedException

Tento zabezpečený řetězec již byl uvolněn.

InvalidOperationException

Tento zabezpečený řetězec je jen pro čtení.

ArgumentOutOfRangeException

index je menší než nula nebo větší než délka tohoto zabezpečeného řetězce.

nebo

Provedením této operace by délka tohoto zabezpečeného řetězce byla větší než 65 536 znaků.

CryptographicException

Při ochraně nebo zrušení ochrany hodnoty tohoto zabezpečeného řetězce došlo k chybě.

Příklady

Následující příklad ukazuje, jak AppendChar, , InsertAt, RemoveAtSetAt, a Clear metody ovlivnit hodnotu objektuSecureString.

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

Poznámky

Index je založený na nule; první znak v tomto zabezpečeném řetězci je na pozici indexu nula.

Pokud implementace používá mechanismus ochrany, jako je šifrování, hodnota zabezpečeného řetězce, pokud existuje, je nechráněná; c se vloží na zadanou pozici indexu; nová hodnota je znovu chráněna. Metoda InsertAt vrátí stejné výsledky jako AppendChar metoda, která vloží znak na konec zabezpečeného řetězce, pokud index je parametr InsertAt nastaven na délku této instance.