Metodo IVSSDatabase.Open

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)

void Open (
	[OptionalAttribute] [InAttribute] string SrcSafeIni,
	[OptionalAttribute] [InAttribute] string Username,
	[OptionalAttribute] [InAttribute] 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.

[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.

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'

Mostra: