Application.UserAppDataPath Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri egy felhasználó alkalmazásadatainak elérési útját.
public:
static property System::String ^ UserAppDataPath { System::String ^ get(); };public static string UserAppDataPath { get; }static member UserAppDataPath : stringPublic Shared ReadOnly Property UserAppDataPath As StringTulajdonság értéke
A felhasználó alkalmazásadatainak elérési útja.
Példák
Az alábbi példakód két űrlapot jelenít meg, és mindkét űrlap bezárásakor kilép az alkalmazásból. Amikor az alkalmazás elindul és kilép, az egyes űrlapok pozíciójára emlékezni fognak. Ez a példa bemutatja, hogy a UserAppDataPath tulajdonság használatával tárolhatja a felhasználó alkalmazásadatait.
Az osztály MyApplicationContext örökli ApplicationContext és nyomon követi az egyes űrlapok bezárását, és mindkét esetben kilép az aktuális szálból. Az osztály az egyes űrlapok pozícióit tárolja a felhasználó számára. Az űrlap pozícióadatait a rendszer egy, a megadott helyen Appdata.txtlétrehozott fájlban UserAppDataPath tárolja. A Main metódus meghívja Application.Run(context) az alkalmazást a megadott időpontban ApplicationContext.
Ez a kód egy részlet az osztály áttekintésében ApplicationContext látható példából. Néhány kód nem jelenik meg a rövidség kedvéért. Tekintse meg ApplicationContext a teljes kódlistát.
MyApplicationContext()
{
_formCount = 0;
// Handle the ApplicationExit event to know when the application is exiting.
Application::ApplicationExit += gcnew EventHandler( this, &MyApplicationContext::OnApplicationExit );
try
{
// Create a file that the application will store user specific data in.
_userData = gcnew FileStream( String::Concat( Application::UserAppDataPath, "\\appdata.txt" ),FileMode::OpenOrCreate );
}
catch ( IOException^ e )
{
// Inform the user that an error occurred.
MessageBox::Show( "An error occurred while attempting to show the application. The error is: {0}", dynamic_cast<String^>(e) );
// Exit the current thread instead of showing the windows.
ExitThread();
}
// Create both application forms and handle the Closed event
// to know when both forms are closed.
_form1 = gcnew AppForm1;
_form1->Closed += gcnew EventHandler( this, &MyApplicationContext::OnFormClosed );
_form1->Closing += gcnew CancelEventHandler( this, &MyApplicationContext::OnFormClosing );
_formCount++;
_form2 = gcnew AppForm2;
_form2->Closed += gcnew EventHandler( this, &MyApplicationContext::OnFormClosed );
_form2->Closing += gcnew CancelEventHandler( this, &MyApplicationContext::OnFormClosing );
_formCount++;
// Get the form positions based upon the user specific data.
if ( ReadFormDataFromFile() )
{
// If the data was read from the file, set the form
// positions manually.
_form1->StartPosition = FormStartPosition::Manual;
_form2->StartPosition = FormStartPosition::Manual;
_form1->Bounds = _form1Position;
_form2->Bounds = _form2Position;
}
// Show both forms.
_form1->Show();
_form2->Show();
}
void OnApplicationExit( Object^ /*sender*/, EventArgs^ /*e*/ )
{
// When the application is exiting, write the application data to the
// user file and close it.
WriteFormDataToFile();
try
{
// Ignore any errors that might occur while closing the file handle.
_userData->Close();
}
catch ( Exception^ )
{
}
}
private:
private MyApplicationContext()
{
_formCount = 0;
// Handle the ApplicationExit event to know when the application is exiting.
Application.ApplicationExit += new EventHandler(this.OnApplicationExit);
try
{
// Create a file that the application will store user specific data in.
_userData = new FileStream(Application.UserAppDataPath + "\\appdata.txt", FileMode.OpenOrCreate);
}
catch (IOException e)
{
// Inform the user that an error occurred.
MessageBox.Show("An error occurred while attempting to show the application." +
"The error is:" + e.ToString());
// Exit the current thread instead of showing the windows.
ExitThread();
}
// Create both application forms and handle the Closed event
// to know when both forms are closed.
_form1 = new AppForm1();
_form1.Closed += new EventHandler(OnFormClosed);
_form1.Closing += new CancelEventHandler(OnFormClosing);
_formCount++;
_form2 = new AppForm2();
_form2.Closed += new EventHandler(OnFormClosed);
_form2.Closing += new CancelEventHandler(OnFormClosing);
_formCount++;
// Get the form positions based upon the user specific data.
if (ReadFormDataFromFile())
{
// If the data was read from the file, set the form
// positions manually.
_form1.StartPosition = FormStartPosition.Manual;
_form2.StartPosition = FormStartPosition.Manual;
_form1.Bounds = _form1Position;
_form2.Bounds = _form2Position;
}
// Show both forms.
_form1.Show();
_form2.Show();
}
private void OnApplicationExit(object sender, EventArgs e)
{
// When the application is exiting, write the application data to the
// user file and close it.
WriteFormDataToFile();
try
{
// Ignore any errors that might occur while closing the file handle.
_userData.Close();
}
catch { }
}
Public Sub New()
MyBase.New()
_formCount = 0
' Handle the ApplicationExit event to know when the application is exiting.
AddHandler Application.ApplicationExit, AddressOf OnApplicationExit
Try
' Create a file that the application will store user specific data in.
_userData = New FileStream(Application.UserAppDataPath + "\appdata.txt", FileMode.OpenOrCreate)
Catch e As IOException
' Inform the user that an error occurred.
MessageBox.Show("An error occurred while attempting to show the application." +
"The error is:" + e.ToString())
' Exit the current thread instead of showing the windows.
ExitThread()
End Try
' Create both application forms and handle the Closed event
' to know when both forms are closed.
_form1 = New AppForm1()
AddHandler _form1.Closed, AddressOf OnFormClosed
AddHandler _form1.Closing, AddressOf OnFormClosing
_formCount = _formCount + 1
_form2 = New AppForm2()
AddHandler _form2.Closed, AddressOf OnFormClosed
AddHandler _form2.Closing, AddressOf OnFormClosing
_formCount = _formCount + 1
' Get the form positions based upon the user specific data.
If (ReadFormDataFromFile()) Then
' If the data was read from the file, set the form
' positions manually.
_form1.StartPosition = FormStartPosition.Manual
_form2.StartPosition = FormStartPosition.Manual
_form1.Bounds = _form1Position
_form2.Bounds = _form2Position
End If
' Show both forms.
_form1.Show()
_form2.Show()
End Sub
Private Sub OnApplicationExit(ByVal sender As Object, ByVal e As EventArgs)
' When the application is exiting, write the application data to the
' user file and close it.
WriteFormDataToFile()
Try
' Ignore any errors that might occur while closing the file handle.
_userData.Close()
Catch
End Try
End Sub
Megjegyzések
Ha egy elérési út nem létezik, a következő formátumban jön létre:
Alap elérési út\CompanyName\ProductName\ProductVersion
Az elérési úton tárolt adatok a felhasználói profil részét képezik, amely engedélyezve van a barangoláshoz. A központi felhasználók egy hálózat több számítógépén is működnek. A központi felhasználó felhasználói profilját a hálózat egy kiszolgálója tárolja, és a rendszer betölti a rendszerbe, amikor a felhasználó bejelentkezik. Ahhoz, hogy egy felhasználói profilt barangolásra lehessen tekinteni, az operációs rendszernek támogatnia kell a központi profilokat, és engedélyeznie kell azt.
Egy tipikus alap elérési út a C:\Documents and Settings\username\Application Data. Ez az elérési út azonban eltérő lesz, ha a Windows Forms alkalmazás a ClickOnce használatával van üzembe helyezve. A ClickOnce saját alkalmazásadatkönyvtárat hoz létre, amely minden más alkalmazástól el van különítve. További információ: Helyi és távoli adatok elérése a ClickOnce-alkalmazásokban.
