SecureString Clase

Referencia

Definición

Espacio de nombres:: System.Security

Ensamblado:: System.Runtime.InteropServices.dll

Ensamblado:: System.Security.SecureString.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Source:: SecureString.cs

Source:: SecureString.cs

Source:: SecureString.cs

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 debe mantenerse confidencial (por ejemplo, mediante su eliminación de la memoria del equipo cuando ya no se necesite). 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: Object
SecureString

Implementaciones: IDisposable

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 de api complementarias para SecureString.

Constructores

SecureString()

Inicializa una nueva instancia de la clase SecureString.

SecureString(Char*, Int32)

Inicializa una nueva instancia de la clase SecureString desde una submatriz de objetos Char.

Este constructor no es conforme a CLS. La alternativa conforme a CLS es SecureString().

Propiedades

Length

Obtiene el número de caracteres de la cadena segura actual.

Métodos

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 que usa el objeto SecureString actual.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve 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 Object actual. (Heredado de Object)
RemoveAt(Int32)	Quita de esta cadena segura el carácter que se encuentra en la posición de índice especificada.
SetAt(Int32, Char)	Reemplaza con otro carácter el carácter existente en la posición de índice especificada.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Compartir a través de