CDaoRecordset::SetFieldNull

void SetFieldNull (void * pv, BOOL bNull = VERDADEIRO);
lançar (CDaoException, CMemoryException);

Parâmetros

pv

Contém o endereço de um membro de dados de campo no conjunto de registros ou NULL. Se NULL, todos os membros de dados campo no conjunto de registros são sinalizados. (C++ NULL não é o mesmo que nulo na terminologia do banco de dados, que significa "com nenhum valor".)

bNull

Diferente de zero se o membro de dados do campo for ser sinalizado como não tendo nenhum valor (Null). Caso contrário 0 se o membro de dados do campo for ser sinalizado como não-Null.

Observações

Chame essa função de membro para sinalizar um membro de dados de campo do conjunto de registros como nulo (especificamente não tendo nenhum valor) ou como não-Null. SetFieldNull é usado para campos acoplados em DoFieldExchange mecanismo.

Quando você adiciona um novo registro a um recordset, todos os membros de dados de campo são inicialmente definidos como um valor nulo e sinalizados como "anormal" (alterado). Quando você recupera um registro de uma fonte de dados, suas colunas já tem valores ou são Null. Se não é conveniente disponibilizar um campo nulo, um CDaoException é lançada.

Se você estiver usando o mecanismo de armazenamento em buffer duplo, por exemplo, se você especificamente desejar designar um campo do registro atual como não tendo um valor, chame SetFieldNull com bNull definido como TRUE para marcá-lo como Null. Se um campo foi anteriormente marcado Null e pretende agora dar-lhe um valor, simplesmente defina o novo valor. Você não deve remover o Sinalizar de nulo com SetFieldNull. Para determinar se o campo pode ser Null, chamar IsFieldNullable.

Se você não estiver usando o mecanismo de armazenamento em buffer duplo, alterando o valor do campo não automaticamente define o campo como sujo e não-Null. Especificamente, você deve definir os campos sujos e não-Null. O sinalizador contidas em m_bCheckCacheForDirtyFields controles essa verificação automático de campo.

O mecanismo DFX emprega o uso deNULL PSEUDO. Para obter mais informações, consulte CDaoFieldExchange::m_nOperation .

Importantenbsp;  Chame essa função de membro somente após ter chamado Editar ou Add&New.

Usar NULL para o primeiro argumento da função será aplicar a função apenas de outputColumns, não params em CDaoFieldExchange. Por exemplo, a chamada

SetFieldNull (NULL)

irá definir somente outputColumns para NULL. O valor do parâmetro não será afetado.

Para obter mais informações sobre troca de campo de registro, consulte os artigos DAO registro campo Exchange (DFX) e DAO Recordset: vinculação dinamicamente registros no Guia do programador do Visual C++.

Visão geral de CDaoRecordsetMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDaoRecordset::SetParamValue

Index