IBM Lotus Symphony


Função CreateUnoValue [Tempo de Execução]

Retorna um objeto que representa o valor estritamente inserido referindo-se ao sistema do tipo Uno.

Esse objeto é convertido automaticamente em um Any do tipo correspondente ao ser transmitido para Uno. O tipo deve ser especificado por seu nome completo de tipo Uno.

Ícone de Nota A API do Lotus® Symphony™ frequentemente usa o tipo Any. Ele é a contraparte do tipo Variante conhecido de outros ambientes. O tipo Any mantém a arbitrariedade do tipo Uno e é usado em interfaces Uno genéricas.

Sintaxe:

oUnoValue = CreateUnoValue( "[]byte", MyBasicValue ) para obter uma sequência de bytes.

Se CreateUnoValue não puder ser convertido no tipo Uno especificado, ocorrerá um erro. Para a conversão, é usado o serviço e TypeConverter.

Essa função destina-se ao uso em situações em que o mecanismo padrão de conversão de tipo Basic em Uno é insuficiente. Isso pode acontecer quando você tentar acessar as interfaces genéricas baseadas em Any, como XPropertySet::setPropertyValue( Name, Value ) ou X???Container::insertBy???( ???, Value ), a partir do Lotus Symphony Basic. O tempo de execução do Basic não reconhece esses tipos, pois eles são definidos somente no serviço correspondente.

Neste tipo de situação, o Lotus Symphony Basic escolhe o melhor tipo correspondente para o tipo Basic que você deseja converter. Entretanto, se for selecionado o tipo incorreto, ocorrerá um erro. Use a função CreateUnoValue() para criar um valor para o tipo Uno desconhecido.

Você também pode usar essa função para transmitir valores diferentes de Any, porém isso não é recomendável. Se o Basic já souber o tipo e destino, o uso da função CreateUnoValue() levará somente às operações de conversão adicionais que tornam mais lenta a execução do Basic.


Feedback do Produto | Documentação Adicional | Marcas Registradas