Compartilhar via


System.PrivateProfileString[String, String, String] Propriedade

Definição

Retorna ou define uma cadeia de caracteres em um arquivo de configurações ou no registro do Windows.

public:
 property System::String ^ PrivateProfileString[System::String ^, System::String ^, System::String ^] { System::String ^ get(System::String ^ FileName, System::String ^ Section, System::String ^ Key); void set(System::String ^ FileName, System::String ^ Section, System::String ^ Key, System::String ^ value); };
public string PrivateProfileString[string FileName, string Section, string Key] { get; set; }
member this.PrivateProfileString(string * string * string) : string with get, set
Public Property PrivateProfileString(FileName As String, Section As String, Key As String) As String

Parâmetros

FileName
String

String necessário. O nome de arquivo do arquivo de configurações. Se não houver nenhum caminho especificado, a pasta do Windows será assumida.

Section
String

String necessário. O nome da seção no arquivo de configurações que contém Key. Em um arquivo de configurações do Windows, o nome da seção aparece entre colchetes antes das chaves associadas (não inclua os colchetes com Section). Se você estiver retornando o valor de uma entrada do registro do Windows, Section deverá ser o caminho completo para a subchave, incluindo o subtree (por exemplo, "HKEY_CURRENT_USER\Software\Microsoft\Office\version \Word\Options").

Key
String

String necessário. A chave cuja configuração ou valor da entrada do Registro você deseja recuperar. Em um arquivo de configurações do Windows, o nome da chave é seguido por um sinal de igual (=) e a configuração. Se você estiver retornando o valor de uma entrada do registro do Windows, Key deverá ser o nome de uma entrada na subchave especificada por (por Section exemplo, "STARTUP-PATH").

Valor da propriedade

Comentários

Você pode escrever um código que usa um arquivo de configurações para armazenar e recuperar configurações. Por exemplo, você pode armazenar o nome do documento ativo quando sair Word para que ele possa ser reaberto automaticamente na próxima vez que iniciar o Microsoft Word. Os arquivos de configurações são arquivos de texto com informações organizadas, como as informações do arquivo WIN.INI do Windows 3.x.

Aplica-se a