SecureString Clase

Definición

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)

Se aplica a

Consulte también