SecureString.InsertAt Method (Int32, Char)


Inserts a character in this secure string at the specified index position.

Namespace:   System.Security
Assembly:  mscorlib (in mscorlib.dll)

member InsertAt : 
        index:int *
        c:char -> unit


Type: System.Int32

The index position where parameter c is inserted.

Type: System.Char

The character to insert.

Exception Condition

This secure string has already been disposed.


This secure string is read-only.


index is less than zero, or greater than the length of this secure string.


Performing this operation would make the length of this secure string greater than 65,536 characters.


An error occurred while protecting or unprotecting the value of this secure string.

The index is zero-based; the first character in this secure string is at index position zero.

If the implementation uses a protection mechanism, such as encryption, the value of the secure string, if any, is unprotected; c is inserted at the specified index position; then the new value is re-protected. The InsertAt method yields the same results as the AppendChar method, which inserts a character at the end of a secure string, if the index parameter of InsertAt is set to the length of this instance.

The following example demonstrates how the AppendChar, InsertAt, RemoveAt, SetAt, and Clear methods affect the value of a SecureString object.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top