SecureString.InsertAt(Int32, Char) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een teken in deze beveiligde tekenreeks in op de opgegeven indexpositie.
public:
void InsertAt(int index, char c);public void InsertAt(int index, char c);[System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions]
public void InsertAt(int index, char c);member this.InsertAt : int * char -> unit[<System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptions>]
member this.InsertAt : int * char -> unitPublic Sub InsertAt (index As Integer, c As Char)Parameters
- index
- Int32
De indexpositie waar de parameter c wordt ingevoegd.
- c
- Char
Het teken dat moet worden ingevoegd.
- Kenmerken
Uitzonderingen
Deze beveiligde tekenreeks is al verwijderd.
Deze beveiligde tekenreeks heeft het kenmerk Alleen-lezen.
index is kleiner dan nul of groter dan de lengte van deze beveiligde tekenreeks.
– of –
Als u deze bewerking uitvoert, wordt de lengte van deze beveiligde tekenreeks groter dan 65.536 tekens.
Er is een fout opgetreden tijdens het beveiligen of opheffen van de beveiliging van de waarde van deze beveiligde tekenreeks.
Voorbeelden
In het volgende voorbeeld ziet u hoe de methoden SetAtClearInsertAtRemoveAtvan AppendCharinvloed zijn op de waarde van een SecureString object.
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
Opmerkingen
De index is gebaseerd op nul; het eerste teken in deze beveiligde tekenreeks bevindt zich op indexpositie nul.
Als de implementatie gebruikmaakt van een beveiligingsmechanisme, zoals versleuteling, is de waarde van de beveiligde tekenreeks, indien aanwezig, niet beveiligd; c wordt ingevoegd op de opgegeven indexpositie. Vervolgens wordt de nieuwe waarde opnieuw beveiligd. De InsertAt methode levert dezelfde resultaten op als de AppendChar methode, waarmee een teken aan het einde van een beveiligde tekenreeks wordt ingevoegd als de index parameter InsertAt is ingesteld op de lengte van dit exemplaar.