SecureString Classe

Definição

Namespace:
System.Security
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Representa o texto que deve ser mantido confidencial, por exemplo, excluindo-o da memória do computador quando não for mais necessário. Essa classe não pode ser herdada.

public ref class SecureString sealed : IDisposable
public sealed class SecureString : IDisposable
type SecureString = class
    interface IDisposable
Public NotInheritable Class SecureString
Implements IDisposable
Herança
Object
SecureString
Implementações
IDisposable

Exemplos

O exemplo a seguir demonstra como usar uma SecureString senha para proteger a senha de um usuário para uso como uma credencial para iniciar um novo processo.

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

Comentários

Para obter mais informações sobre essa API, consulte comentários da API Complementar para SecureString.

Construtores

Nome Description
SecureString()

Inicializa uma nova instância da classe SecureString.
SecureString(Char*, Int32)

Inicializa uma nova instância da classe de SecureString uma subarray de Char objetos.

Esse construtor não é compatível com CLS. A alternativa compatível com CLS é SecureString().

Propriedades

Nome Description
Length

Obtém o número de caracteres na cadeia de caracteres segura atual.

Métodos

Nome Description
AppendChar(Char)

Acrescenta um caractere ao final da cadeia de caracteres segura atual.
Clear()

Exclui o valor da cadeia de caracteres segura atual.
Copy()

Cria uma cópia da cadeia de caracteres segura atual.
Dispose()

Libera todos os recursos usados pelo objeto atual SecureString .
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InsertAt(Int32, Char)

Insere um caractere nessa cadeia de caracteres segura na posição de índice especificada.
IsReadOnly()

Indica se essa cadeia de caracteres segura está marcada como somente leitura.
MakeReadOnly()

Torna o valor de texto dessa cadeia de caracteres segura somente leitura.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
RemoveAt(Int32)

Remove o caractere na posição de índice especificada dessa cadeia de caracteres segura.
SetAt(Int32, Char)

Substitui o caractere existente na posição de índice especificada por outro caractere.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também