Udostępnij za pośrednictwem


SecureString Konstruktory

Definicja

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
Źródło:
SecureString.cs
Źródło:
SecureString.cs

Inicjuje nowe wystąpienie klasy SecureString.

public:
 SecureString();
public SecureString ();
Public Sub New ()

Wyjątki

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

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.

Dotyczy

SecureString(Char*, Int32)

Źródło:
SecureString.cs
Źródło:
SecureString.cs
Ź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)]
[System.Security.SecurityCritical]
public SecureString (char* value, int length);
[<System.CLSCompliant(false)>]
new System.Security.SecureString : nativeptr<char> * int -> System.Security.SecureString
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Wyjątki

value to null.

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

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

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.

Dotyczy