Scripts.Item(Object) Método

Definição

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Retorna um membro da Scripts coleção.

public:
 Microsoft::Office::Core::Script ^ Item(System::Object ^ Index);

public Microsoft.Office.Core.Script Item (object Index);

abstract member Item : obj -> Microsoft.Office.Core.Script

Public Function Item (Index As Object) As Script

Parâmetros

Index

Object

Objeto obrigatório. A ID ou o número de índice do script a ser retornado.

Retornos

Script

Comentários

Aceita o número de índice ou A ID do script que você deseja que o aplicativo do Microsoft Office retorne. O método Item aceita um valor object que pode aceitar um número ordinal (valor de índice), que retorna o script armazenado nessa posição na coleção Scripts ou um valor String que representa o nome ou a ID do script.

A coleção Scripts contém todos os scripts em um determinado documento, em ordem de origem (a ordem em que Script os objetos aparecem no arquivo de origem). Os scripts são mantidos em ordem de origem, independentemente de sua localização no documento – ou seja, se estão no cabeçalho ou no texto do corpo.

Você pode usar o método Item para acessar um script na coleção Scripts usando a ID da <marca SCRIPT> . O atributo ID da <marca SCRIPT> é idêntico à Id propriedade do objeto Script . Se houver IDs duplicadas ou múltiplas no documento e você usar a propriedade Id de um objeto Script para acessar um script usando o método Item , o Office retornará o primeiro script que corresponde à ID; scripts adicionais com a mesma ID são ignorados.

Novas âncoras de script adicionadas à coleção são acrescentadas ao final da coleção Scripts na ordem em que foram adicionadas ao documento. As âncoras de script permanecem nessa ordem até que o documento seja salvo como HTML, fechado e aberto novamente no aplicativo host. Seguir essas etapas faz com que a coleção Scripts seja indexada na ordem em que as âncoras de script aparecem no documento, o que pode ser diferente da ordem na qual foram adicionadas a ela. Portanto, você é aconselhado a usar a propriedade Id do objeto Script , em vez da posição do script na coleção, para garantir a identificação positiva do script.