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 um caminho especificado, a pasta Windows será usada.
- 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 incluam os colchetes com Section ). Se você estiver retornando o valor de uma entrada do registro do Windows, Section o caminho completo para a subchave, incluindo a subárvore (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 deve ser o nome de uma entrada na subchave especificada por Section (por 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 ao encerrar o Word para que ele possa ser reaberto automaticamente na próxima vez que você 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.