SecureString Konstruktory

Definicja

Przestrzeń nazw:

System.Security

Zestaw:

System.Runtime.InteropServices.dll

Inicjuje nowe wystąpienie klasy SecureString.

Przeciążenia

SecureString()	Inicjuje nowe wystąpienie klasy SecureString.
SecureString(Char*, Int32)	Inicjuje SecureString nowe wystąpienie klasy z podarray Char obiektów. Ten konstruktor nie jest zgodny ze specyfikacją CLS. Alternatywą zgodną ze standardem CLS jest SecureString().

SecureString()

Źródło:

SecureString.cs

Inicjuje nowe wystąpienie klasy SecureString.

public:
 SecureString();

public SecureString ();

Public Sub New ()

Wyjątki

CryptographicException

Wystąpił błąd podczas ochrony lub wyłączania ochrony wartości tego wystąpienia.

NotSupportedException

Ta operacja nie jest obsługiwana na tej platformie.

Przykłady

W poniższym przykładzie użyto domyślnego (lub bez parametrów) konstruktora do utworzenia wystąpienia nowego SecureString obiektu. Następnie wywołuje metodę AppendChar , aby dodać do niej tablicę znaków.

using namespace System;
using namespace System::Security;

int main(array<System::String ^> ^args)
{
   // Define the string value to assign to a new secure string.
   Char chars[4] = { 't', 'e', 's', 't' };
   // Instantiate the secure string.
   SecureString^ testString = gcnew SecureString();
   // Assign the character array to the secure string.
   for each (Char ch in chars)
   {
      testString->AppendChar(ch);
   }   
   // Display secure string length.
   Console::WriteLine("The length of the string is {0} characters.", 
                        testString->Length);

   delete testString;
   return 0;
}
// The example displays the following output:
//      The length of the string is 4 characters.

using System;
using System.Security;

public class Example
{
   public static void Main()
   {
      // Define the string value to assign to a new secure string.
      char[] chars = { 't', 'e', 's', 't' };
      // Instantiate the secure string.
      SecureString testString = new SecureString();
      // Assign the character array to the secure string.
      foreach (char ch in chars)
         testString.AppendChar(ch);      
      // Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", 
                        testString.Length);
      testString.Dispose();
   }
}
// The example displays the following output:
//      The length of the string is 4 characters.

Imports System.Security

Module Example
   Public Sub Main()
      ' Define the string value to assign to a new secure string.
      Dim chars() As Char = { "t"c, "e"c, "s"c, "t"c }
      ' Instantiate the secure string.
      Dim testString As SecureString = New SecureString()
      ' Assign the character array to the secure string.
      For Each ch As char In chars
         testString.AppendChar(ch)
      Next         
      ' Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", _ 
                        testString.Length)
      testString.Dispose()
   End Sub
End Module
' The example displays the following output:
'      The length of the string is 4 characters.

Poniższy przykład tworzy SecureString obiekt na podstawie wartości String obiektu.

using namespace System;
using namespace System::Security;

int main(array<System::String ^> ^args)
{
   // Define the string value to be assigned to the secure string.
   String^ initString = "TestString";
   // Instantiate the secure string.
   SecureString^ testString = gcnew SecureString();
   // Assign the character array to the secure string.
   for each (Char ch in initString)
   {
      testString->AppendChar(ch);
   }   
   // Display secure string length.
   Console::WriteLine("The length of the string is {0} characters.", 
                        testString->Length);

   delete testString;
   return 0;
}
// The example displays the following output:
//      The length of the string is 10 characters.

using System;
using System.Security;

public class Example
{
   public static void Main()
   {
      // Define the string value to be assigned to the secure string.
      string initString = "TestString";
      // Instantiate the secure string.
      SecureString testString = new SecureString();
      // Use the AppendChar method to add each char value to the secure string.
      foreach (char ch in initString)
         testString.AppendChar(ch);
         
      // Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", 
                        testString.Length);
      testString.Dispose();
   }
}
// The example displays the following output:
//      The length of the string is 10 characters.

Imports System.Security

Module Example
   Public Sub Main()
      ' Define the string value to be assigned to the secure string.
      Dim initString As String = "TestString"
      ' Instantiate the secure string.
      Dim testString As SecureString = New SecureString()
      ' Use the AppendChar method to add each char value to the secure string.
      For Each ch As Char In initString
         testString.AppendChar(ch)
      Next   
      ' Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", _ 
                        testString.Length)
      testString.Dispose()
   End Sub
End Module
' The example displays the following output:
'      The length of the string is 10 characters.

SecureString(Char*, Int32)

Źródło:

SecureString.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje SecureString nowe wystąpienie klasy z podarray Char obiektów.

Ten konstruktor nie jest zgodny ze specyfikacją CLS. Alternatywą zgodną ze standardem CLS jest SecureString().

public:
 SecureString(char* value, int length);

[System.CLSCompliant(false)]
public SecureString (char* value, int length);

[<System.CLSCompliant(false)>]
new System.Security.SecureString : nativeptr<char> * int -> System.Security.SecureString

Parametry

value

Char*

Wskaźnik do tablicy Char obiektów.

length

Int32

Liczba elementów value do uwzględnienia w nowym wystąpieniu.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value to null.

ArgumentOutOfRangeException

length wartość jest mniejsza niż zero lub większa niż 65 536.

CryptographicException

Wystąpił błąd podczas ochrony lub wyłączania ochrony wartości tego bezpiecznego ciągu.

NotSupportedException

Ta operacja nie jest obsługiwana na tej platformie.

Przykłady

Poniższy przykład tworzy wystąpienie nowego SecureString obiektu, przekazując jego konstruktorowi wskaźnik do tablicy znaków.

using namespace System;
using namespace System::Security;

int main(array<System::String ^> ^args)
{
   SecureString^ testString;
   // Define the string value to assign to a new secure string.
   Char chars[4] = { 't', 'e', 's', 't' };
   // Instantiate a new secure string.
   Char* pChars = &chars[0];

   testString = gcnew SecureString(pChars, sizeof(chars)/sizeof(chars[0]));

   // Display secure string length.
   Console::WriteLine("The length of the string is {0} characters.", 
                        testString->Length);
   delete testString;
   return 0;
}
// The example displays the following output:
//      The length of the string is 4 characters.

using System;
using System.Security;

public class Example
{
   unsafe public static void Main()
   {
      SecureString testString;
      // Define the string value to assign to a new secure string.
      char[] chars = { 't', 'e', 's', 't' };

      // Instantiate a new secure string.
      fixed(char* pChars = chars)
      {
         testString = new SecureString(pChars, chars.Length);
      }
      // Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", 
                        testString.Length);
      testString.Dispose();
   }
}
// The example displays the following output:
//      The length of the string is 4 characters.

Uwagi

Ten konstruktor inicjuje nowy SecureString obiekt do liczby znaków value określonych przez length; wartość wystąpienia jest następnie szyfrowana.

W języku C#ten konstruktor jest zdefiniowany tylko w kontekście niebezpiecznego kodu.