_Items.SetColumns(String) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

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:

	AutoResolvedWinner	InternetCodePage
	Corpo	MeetingWorkspaceURL
	BodyFormat	MemberCount
	Categorias	ReceivedByEntryID
	Children	ReceivedOnBehalfOfEntryID
	Classe	RecurrenceState
	Empresas	ReplyRecipients
	DLName	ResponseState
	DownloadState	Saved
	EntryID	Sent
	HTMLBody	Submitted
	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.