SecureString.InsertAt(Int32, Char) Yöntem

Tanım

Ad Alanı:

System.Security

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Kaynak:

SecureString.cs

Bu güvenli dizeye belirtilen dizin konumunda bir karakter ekler.

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)

Parametreler

index

Int32

Parametrenin c eklendiği dizin konumu.

c

Char

Eklenecek karakter.

Özel durumlar

ObjectDisposedException

Bu güvenli dize zaten atılmış.

InvalidOperationException

Bu güvenli dize salt okunurdur.

ArgumentOutOfRangeException

index sıfırdan küçük veya bu güvenli dizenin uzunluğundan büyük.

-veya-

Bu işlemin gerçekleştirilmesi, bu güvenli dizenin uzunluğunun 65.536 karakterden uzun olmasını sağlar.

CryptographicException

Bu güvenli dizenin değeri korunurken veya koruması kaldırılırken bir hata oluştu.

Örnekler

Aşağıdaki örnekte , , , , AppendCharve InsertAt yöntemlerinin RemoveAtbir SetAt nesnenin değerini nasıl etkilediği Cleargösterilmektedir. SecureString

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

Açıklamalar

Dizin sıfır tabanlıdır; bu güvenli dizedeki ilk karakter sıfır dizin konumundadır.

Uygulama şifreleme gibi bir koruma mekanizması kullanıyorsa, varsa güvenli dizenin değeri korumasızdır; c belirtilen dizin konumuna eklenir; ardından yeni değer yeniden korunur. InsertAt yöntemi, parametresi bu örneğin uzunluğuna AppendChar ayarlanmışsaindex, güvenli dizenin sonuna bir karakter ekleyen yöntemiyle InsertAt aynı sonuçları verir.