Compartilhar via


_Items.SetColumns(String) Método

Definição

Armazena em cache determinadas propriedades para acesso extremamente rápido às propriedades específicas de um item no conjunto.

public:
 void SetColumns(System::String ^ Columns);
public void SetColumns (string Columns);
Public Sub SetColumns (Columns As String)

Parâmetros

Columns
String

Uma cadeia de caracteres que contém os nomes das propriedades a serem armazenadas em cache. Os nomes das propriedades são delimitados por vírgula nessa cadeia de caracteres.

Comentários

O método SetColumns é útil para iteração por meio da Items coleção. Se você não usar esse método, Microsoft Outlook deve abrir cada item para acessar a propriedade. Com o método SetColumns, o Outlook somente verifica as propriedades que você tiver no cache e fornece acesso rápido e somente leitura a essas propriedades.

Depois de aplicar o método SetColumns nas propriedades específicas da coleção, você não pode ler as outras propriedades dessa coleção; propriedades que não estiverem armazenadas serão retornadas vazias. Você não pode escrever ou para qualquer uma das propriedades dessa coleção. Como alternativa, se você precisar de leitura-gravação, acesso rápido a um conjunto de itens, use o Table objeto.

SetColumns não pode ser usado e causará um erro, com qualquer propriedade que retorna um objeto. Ele não pode ser usado com as seguintes propriedades:

AutoResolvedWinnerInternetCodePage
CorpoMeetingWorkspaceURL
BodyFormat MemberCount
CategoriasReceivedByEntryID
Children ReceivedOnBehalfOfEntryID
Classe RecurrenceState
EmpresasReplyRecipients
DLName ResponseState
DownloadStateSaved
EntryIDSent
HTMLBodySubmitted
IsConflict VotingOptions

Propriedade ConversationIndex não pode ser armazenados em cache usando o método SetColumns. No entanto, essa propriedade não resultará em erro como as outras propriedades listadas acima.

Aplica-se a