Export (0) Print
Expand All

SecureString.RemoveAt Method

Removes the character at the specified index position from this secure string.

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

[<HandleProcessCorruptedStateExceptionsAttribute>]
member RemoveAt : 
        index:int -> unit

Parameters

index
Type: System.Int32

The index position of a character in this secure string.

ExceptionCondition
ObjectDisposedException

This secure string has already been disposed.

InvalidOperationException

This secure string is read-only.

ArgumentOutOfRangeException

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

CryptographicException

An error occurred while encrypting or decrypting the value of this secure string.

The index is zero-based and the first character in this instance is at index position zero.

The value of this secure string, if any, is decrypted; the character at the specified index position is removed; then the new value is encrypted.

The following code 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.

The following code example demonstrates how the AppendChar and RemoveAt methods can be used to collect the characters in a password.

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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft