SecureString Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa el texto que se debe mantener confidencial, como eliminarlo de la memoria del equipo cuando ya no sea necesario. Esta clase no puede heredarse.
public ref class SecureString sealed : IDisposable
public sealed class SecureString : IDisposable
type SecureString = class
interface IDisposable
Public NotInheritable Class SecureString
Implements IDisposable
- Herencia
-
SecureString
- Implementaciones
Ejemplos
En el ejemplo siguiente se muestra cómo usar para SecureString proteger la contraseña de un usuario para usarla como credencial para iniciar un nuevo proceso.
using System;
using System.ComponentModel;
using System.Diagnostics;
using System.Security;
public class Example
{
public static void Main()
{
// Instantiate the secure string.
SecureString securePwd = new SecureString();
ConsoleKeyInfo key;
Console.Write("Enter password: ");
do {
key = Console.ReadKey(true);
// Ignore any key out of range.
if (((int) key.Key) >= 65 && ((int) key.Key <= 90)) {
// Append the character to the password.
securePwd.AppendChar(key.KeyChar);
Console.Write("*");
}
// Exit if Enter key is pressed.
} while (key.Key != ConsoleKey.Enter);
Console.WriteLine();
try {
Process.Start("Notepad.exe", "MyUser", securePwd, "MYDOMAIN");
}
catch (Win32Exception e) {
Console.WriteLine(e.Message);
}
finally {
securePwd.Dispose();
}
}
}
Imports System.ComponentModel
Imports System.Diagnostics
Imports System.Security
Public Class Example
Public Shared Sub Main()
' Instantiate the secure string.
Dim securePwd As New SecureString()
Dim key As ConsoleKeyInfo
Console.Write("Enter password: ")
Do
key = Console.ReadKey(True)
' Ignore any key out of range
If CInt(key.Key) >= 65 And CInt(key.Key <= 90) Then
' Append the character to the password.
securePwd.AppendChar(key.KeyChar)
Console.Write("*")
End If
' Exit if Enter key is pressed.
Loop While key.Key <> ConsoleKey.Enter
Console.WriteLine()
Try
Process.Start("Notepad.exe", "MyUser", securePwd, "MYDOMAIN")
Catch e As Win32Exception
Console.WriteLine(e.Message)
Finally
securePwd.Dispose()
End Try
End Sub
End Class
Comentarios
Para obtener más información sobre esta API, consulte Comentarios complementarios de api para SecureString.
Constructores
| Nombre | Description |
|---|---|
| SecureString() |
Inicializa una nueva instancia de la clase SecureString. |
| SecureString(Char*, Int32) |
Inicializa una nueva instancia de la SecureString clase a partir de una subbarray de Char objetos. Este constructor no es compatible con CLS. La alternativa conforme a CLS es SecureString(). |
Propiedades
| Nombre | Description |
|---|---|
| Length |
Obtiene el número de caracteres de la cadena segura actual. |
Métodos
| Nombre | Description |
|---|---|
| AppendChar(Char) |
Anexa un carácter al final de la cadena segura actual. |
| Clear() |
Elimina el valor de la cadena segura actual. |
| Copy() |
Crea una copia de la cadena segura actual. |
| Dispose() |
Libera todos los recursos utilizados por el objeto actual SecureString . |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| InsertAt(Int32, Char) |
Inserta un carácter en esta cadena segura en la posición de índice especificada. |
| IsReadOnly() |
Indica si esta cadena segura está marcada como de solo lectura. |
| MakeReadOnly() |
Hace que el valor de texto de esta cadena segura sea de solo lectura. |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| RemoveAt(Int32) |
Quita el carácter en la posición de índice especificada de esta cadena segura. |
| SetAt(Int32, Char) |
Reemplaza el carácter existente en la posición de índice especificada por otro carácter. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |