System.PrivateProfileString[String, String, String] Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.