Metodo IVSSDatabase.Open

  • Articolo

Connette un utente al database di Visual SourceSafe.

Spazio dei nomi: Microsoft.VisualStudio.SourceSafe.Interop
Assembly: Microsoft.VisualStudio.SourceSafe.Interop (in microsoft.visualstudio.sourcesafe.interop.dll)

Sintassi

'Dichiarazione
Sub Open ( _
    <InAttribute> <OptionalAttribute> Optional SrcSafeIni As String = "", _
    <InAttribute> <OptionalAttribute> Optional Username As String = "", _
    <InAttribute> <OptionalAttribute> Optional Password As String = "" _
)
'Utilizzo
Dim instance As IVSSDatabase
Dim SrcSafeIni As String
Dim Username As String
Dim Password As String

instance.Open(SrcSafeIni, Username, Password)

void Open (
    [OptionalAttribute] [InAttribute] string SrcSafeIni,
    [OptionalAttribute] [InAttribute] string Username,
    [OptionalAttribute] [InAttribute] string Password
)

void Open (
    [InAttribute] [OptionalAttribute] String^ SrcSafeIni, 
    [InAttribute] [OptionalAttribute] String^ Username, 
    [InAttribute] [OptionalAttribute] String^ Password
)

void Open (
    /** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String SrcSafeIni, 
    /** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Username, 
    /** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ String Password
)

function Open (
    SrcSafeIni : String, 
    Username : String, 
    Password : String
)

Parametri

  • SrcSafeIni
    Il percorso completo, incluso il nome, del file srcsafe.ini relativo al database corrente di Visual SourceSafe.
  • Username
    Il nome dell'utente di Visual SourceSafe che tenta di eseguire l'accesso al database di Visual SourceSafe. Il valore predefinito è il nome dell'utente connesso alla sessione di Windows.
  • Password
    La password dell'utente di Visual SourceSafe che tenta di eseguire l'accesso al database di Visual SourceSafe. Il valore predefinito è una stringa vuota.

Note

[IDL]

HRESULT Open ([in,defaultvalue(0)]BSTR SrcSafeIni, [in,defaultvalue(0)]BSTR Username, [in,defaultvalue(0)]BSTR Password);

È consentito aprire più database simultaneamente. Un oggetto database specifico può tuttavia fare riferimento a un solo database alla volta.

Se viene passato un percorso non valido, verrà generato un errore di run-time. Quando il parametro viene omesso, il file SRCSAFE.INI viene cercato in base al seguente ordine:

  1. Directory in cui si trova SSAPI.DLL.

  2. Percorso della directory di SSAPI.DLL. Ad esempio, se SSAPI.DLL si trova in C:\Folder1\Folder2\Folder3\SSAPI.DLL, la ricerca viene effettuata, nell'ordine, in Folder3, Folder2, Folder1 e C:\.

  3. Percorso indicato dal valore denominato "SCCProviderPath" o " SCCServerPath" nella chiave del Registro di sistema HKEY_LOCAL_MACHINE\Software\Microsoft\SourceSafe.

Se si specifica un valore non valido per Username o Password, verrà generato un errore di run-time. Se un utente non dispone di una password, verrà specificata una stringa vuota.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare il metodo Open per accedere al database di Visual SourceSafe.

[C#]

using System;
using Microsoft.VisualStudio.SourceSafe.Interop;

public class IVSSTest
{
    public static void Main()
    {
        // Create a VSSDatabase object.
        IVSSDatabase vssDatabase = new VSSDatabase();

        // Open a VSS database using network name 
        // for automatic user login.
        vssDatabase.Open(@"C:\VSSTestDB\srcsafe.ini", 
                         Environment.UserName, 
                         ""); 
        // Display user's current project. 
        Console.WriteLine("The {0}'s current project is '{1}'", 
                          vssDatabase.Username, vssDatabase.CurrentProject);
    }
}

Output:

The Guest's current project is '$/MyProject'

Vedere anche

Riferimenti

Interfaccia IVSSDatabase
Membri IVSSDatabase
Spazio dei nomi Microsoft.VisualStudio.SourceSafe.Interop