SecureString.InsertAt(Int32, Char) Metódus

Definíció

Névtér:

System.Security

Szerelvények:

netstandard.dll, System.Runtime.InteropServices.dll

Forrás:

SecureString.cs

Beszúr egy karaktert ebbe a biztonságos sztringbe a megadott indexpozícióban.

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)

Paraméterek

index

Int32

Az index pozíciója, ahol a paraméter c be van szúrva.

c

Char

A beszúrni kívánt karakter.

Kivételek

ObjectDisposedException

Ez a biztonságos sztring már el lett adva.

InvalidOperationException

Ez a biztonságos sztring írásvédett.

ArgumentOutOfRangeException

index kisebb, mint nulla, vagy nagyobb, mint a biztonságos sztring hossza.

-vagy-

A művelet végrehajtásával a biztonságos sztring hossza 65 536 karakternél hosszabb lesz.

CryptographicException

Hiba történt a biztonságos sztring értékének védelme vagy feloldása során.

Példák

Az alábbi példa bemutatja, hogy a AppendChar, InsertAt, RemoveAt, SetAtés Clear metódusok hogyan befolyásolják egy SecureString objektum értékét.

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

Megjegyzések

Az index nulla alapú; a biztonságos sztring első karaktere nulla indexpozícióban van.

Ha az implementáció védelmi mechanizmust ( például titkosítást) használ, a biztonságos sztring értéke (ha van ilyen) nem védett; c a rendszer beszúrja a megadott indexpozícióba, majd az új érték ismét védett lesz. A InsertAt metódus ugyanazt az eredményt adja, mint a AppendChar metódus, amely beszúr egy karaktert egy biztonságos sztring végére, ha a index paraméter InsertAt értéke a példány hosszára van állítva.