SecureString Kelas

Definisi

Ruang nama:

System.Security

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

SecureString.cs

Mewakili teks yang harus dirahasiakan, seperti dengan menghapusnya dari memori komputer saat tidak lagi diperlukan. Kelas ini tidak dapat diwariskan.

public ref class SecureString sealed : IDisposable

public sealed class SecureString : IDisposable

type SecureString = class
    interface IDisposable

Public NotInheritable Class SecureString
Implements IDisposable

Warisan

Object

SecureString

Penerapan

IDisposable

Contoh

Contoh berikut menunjukkan cara menggunakan SecureString untuk mengamankan kata sandi pengguna untuk digunakan sebagai kredensial untuk memulai proses baru.

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

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk SecureString.

Konstruktor

SecureString()	Menginisialisasi instans baru kelas SecureString.
SecureString(Char*, Int32)	Menginisialisasi instans SecureString baru kelas dari subarray Char objek. Konstruktor ini tidak sesuai dengan CLS. Alternatif yang mematuhi CLS adalah SecureString().

Properti

Length

Mendapatkan jumlah karakter dalam string aman saat ini.

Metode

AppendChar(Char)	Menambahkan karakter ke akhir string aman saat ini.
Clear()	Menghapus nilai string aman saat ini.
Copy()	Membuat salinan string aman saat ini.
Dispose()	Melepaskan semua sumber daya yang digunakan oleh objek saat ini SecureString .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InsertAt(Int32, Char)	Menyisipkan karakter dalam string aman ini pada posisi indeks yang ditentukan.
IsReadOnly()	Menunjukkan apakah string aman ini ditandai sebagai baca-saja.
MakeReadOnly()	Membuat nilai teks dari string aman ini baca-saja.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
RemoveAt(Int32)	Menghapus karakter pada posisi indeks yang ditentukan dari string aman ini.
SetAt(Int32, Char)	Mengganti karakter yang ada pada posisi indeks yang ditentukan dengan karakter lain.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• ComVisibleAttribute
• Marshal
• CriticalFinalizerObject
• IDisposable