SecureString Costruttori

  • Riferimento

Definizione

Spazio dei nomi:
System.Security
Assembly:
System.Runtime.InteropServices.dll
Assembly:
System.Security.SecureString.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Inizializza una nuova istanza della classe SecureString.

Overload

SecureString()

Inizializza una nuova istanza della classe SecureString.
SecureString(Char*, Int32)

Inizializza una nuova istanza della classe SecureString da una sottomatrice di oggetti Char.

Questo costruttore non è conforme a CLS. L'alternativa conforme a CLS è SecureString().

SecureString()

Source:
SecureString.cs
Source:
SecureString.cs
Source:
SecureString.cs

Inizializza una nuova istanza della classe SecureString.

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

Eccezioni

CryptographicException

Si è verificato un errore durante la protezione o la rimozione della protezione del valore di questa istanza.

NotSupportedException

Questa operazione non è supportata su questa piattaforma.

Esempio

Nell'esempio seguente viene utilizzato il costruttore predefinito (o senza parametri) per creare un'istanza di un nuovo SecureString oggetto. Chiama quindi il AppendChar metodo per aggiungervi una matrice di caratteri.

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.

Nell'esempio seguente viene creato un SecureString oggetto dal valore di un String oggetto .

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.

Si applica a

SecureString(Char*, Int32)

Source:
SecureString.cs
Source:
SecureString.cs
Source:
SecureString.cs

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della classe SecureString da una sottomatrice di oggetti Char.

Questo costruttore non è conforme a CLS. L'alternativa conforme a CLS è 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

Parametri

value
Char*

Puntatore a una matrice di oggetti Char.

length
Int32

Numero di elementi di value da includere nella nuova istanza.

Attributi
CLSCompliantAttribute SecurityCriticalAttribute

Eccezioni

ArgumentNullException

value è null.

ArgumentOutOfRangeException

length è minore di zero o maggiore di 65.536.

CryptographicException

Si è verificato un errore durante la protezione o la rimozione della protezione del valore di questa stringa protetta.

NotSupportedException

Questa operazione non è supportata su questa piattaforma.

Esempio

Nell'esempio seguente viene creata un'istanza di un nuovo SecureString oggetto passando il relativo costruttore a un puntatore a una matrice di caratteri.

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.

Commenti

Questo costruttore inizializza il nuovo SecureString oggetto al numero di caratteri specificato value da length. Il valore dell'istanza viene quindi crittografato.

In C# questo costruttore viene definito solo nel contesto del codice non sicuro.

Si applica a