SecureString Osztály

Definíció

Névtér:
System.Security
Szerelvények:
netstandard.dll, System.Runtime.InteropServices.dll
Szerelvény:
System.Security.SecureString.dll
Szerelvény:
System.Runtime.InteropServices.dll
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll
Forrás:
SecureString.cs
Forrás:
SecureString.cs
Forrás:
SecureString.cs
Forrás:
SecureString.cs
Forrás:
SecureString.cs

Olyan szöveget jelöl, amelyet bizalmasan kell kezelni, például ha törli azt a számítógép memóriájából, amikor már nincs rá szükség. Ez az osztály nem örökölhető.

public ref class SecureString sealed : IDisposable
public sealed class SecureString : IDisposable
type SecureString = class
    interface IDisposable
Public NotInheritable Class SecureString
Implements IDisposable
Öröklődés
Object
SecureString
Megvalósítás
IDisposable

Példák

Az alábbi példa bemutatja, hogyan védhet meg egy SecureString felhasználó jelszavát hitelesítő adatként egy új folyamat elindításához.

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

Megjegyzések

További információ erről az API-ról: Kiegészítő API-megjegyzések a SecureStringhez.

Konstruktorok

Name Description
SecureString()

Inicializálja a SecureString osztály új példányát.
SecureString(Char*, Int32)

Inicializálja az osztály új példányát az SecureString objektumok egy alarrájából Char .

Ez a konstruktor nem CLS-kompatibilis. A CLS-kompatibilis alternatíva a SecureString().

Tulajdonságok

Name Description
Length

Lekéri az aktuális biztonságos sztringben szereplő karakterek számát.

Metódusok

Name Description
AppendChar(Char)

Hozzáfűz egy karaktert az aktuális biztonságos sztring végéhez.
Clear()

Törli az aktuális biztonságos sztring értékét.
Copy()

Létrehozza az aktuális biztonságos sztring másolatát.
Dispose()

Felszabadítja az aktuális SecureString objektum által használt összes erőforrást.
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
InsertAt(Int32, Char)

Beszúr egy karaktert ebbe a biztonságos sztringbe a megadott indexpozícióban.
IsReadOnly()

Azt jelzi, hogy ez a biztonságos sztring írásvédettként van-e megjelölve.
MakeReadOnly()

A biztonságos sztring szöveges értékét írásvédetté teszi.
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
RemoveAt(Int32)

Eltávolítja a megadott indexpozícióban lévő karaktert ebből a biztonságos sztringből.
SetAt(Int32, Char)

A megadott indexpozícióban lévő meglévő karaktert lecseréli egy másik karakterre.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

A következőre érvényes:

Lásd még