Be om status og annen informasjon
Etter at du har åpnet en DDE-kanal til Microsoft Query, kan du returnere et resultatsett eller annen informasjon ved hjelp av DDERequest.
DDERequest-metoden har to argumenter:
| Argument | Beskrivelse |
|---|---|
| Kanal | DDE-kanalverdien som returneres av DDEInitiate. |
| Anmodningselement | Dataene som skal returneres. Det kan dreie seg om innholdet i et felt eller feltområde i et spørringsvindu, eller andre typer informasjon som for eksempel antallet poster i et spørringsvindu. |
Det er mulig å anmode om elementer både på spørringskanalen og systemkanalen. På spørringskanalen kan du bare returnere informasjon om spørringen, for eksempel antall rader eller kolonner, eller spørringsdefinisjonen. På systemkanalen kan du returnere generell informasjon om Microsoft Query, som for eksempel gjeldende tilkoblinger, emnenavn og programstatus, og dessuten informasjon som bare gjelder for den aktive spørringen.
Følgende anmodningselementer kan brukes for en spørringskanal, eller for den aktive spørringen på en systemkanal:
| Anmodningselement | Informasjon som returneres |
|---|---|
| ColumnTitles | En matrise med kolonnetitler. Kolonnetittelen er lik feltnavnet, med mindre brukeren har endret kolonnetittelen i Microsoft Query. |
| ConnectionString | En matrise med tilkoblingsstreng-segmenter (der hvert segment kan inneholde opptil 255 tegn) som til sammen danner tilkoblingsstrengen som brukes til å opprette forbindelse med det aktive spørringsvinduet. Hvis spørringen ble laget på grunnlag av et fildatakildenavn, vil dette elementet returnere en tilkoblingsstreng uten datakildenavn (DSN). |
| ConnectionString/n | En matrise med tilkoblingsstrengsegmenter (der hvert segment kan inneholde opptil n tegn) som til sammen danner tilkoblingsstrengen som brukes til å opprette forbindelse med det aktive spørringsvinduet. Hvis spørringen ble laget på grunnlag av et fildatakildenavn, vil dette elementet returnere en tilkoblingsstreng uten datakildenavn. |
| DataSourceName | Navnet på datakilden (DSN) som brukes i den aktive spørringen. |
| ErrorText | En eventuell feiltekst fra SQL-setningen som ble utført sist. Dette elementet kan en anmode om flere ganger, slik at alle feil som har oppstått, blir mottatt. Etter at alle feilene er hentet, vil elementet returnere en tom streng. Elementet returnerer en tom streng hvis SQL-setningen som ble utført sist var vellykket, selv om SQL-setninger som ble utført tidligere, ikke var det. |
| FieldDef | En matrise med verdier som beskriver uttrykkene og datatypene for kolonnene (feltene) i spørringsvinduet. Hver rad i matrisen beskriver et felt i spørringen. Matrisen returnerer følgende data i kolonneformat: feltnavnet, Q+E-datatypen for feltet, feltbredden, feltpresisjonen, og SQL-datatypen for feltet. |
| GetUniqueItems | En matrise over de unike elementene i en gitt kolonne i spørringsresultatene. Elementet det faktisk anmodes om, må være den nullbaserte kolonneindeksen til kolonnen som er føyd til "GetUniqueItems" (for eksempel vil de unike elementene i den andre kolonnen bli returnert av "GetUniqueItems1"). Du kan ikke anmode om de unike elementene for en kolonne som ikke er med i spørringen.
Dette elementet returnerer de samme verdiene som en SELECT DISTINCT-setning for kolonnen det ble anmodet om, og eventuelle koblinger og setningsdeler for vilkår vil være aktive. Eventuelle setningsdeler for vilkår som bruker parametere, tas ikke med. |
| NameSeparator | Tegnet som brukes som skilletegn for ODBC-kvalifikatornavnet. |
| NumCols | Antall kolonner (felt) i spørringen. |
| NumRows | Antall rader (poster) i spørringen. |
| ODBCSQLStatement | En matrise med SQL-segmenter (som kan inneholde opptil 255 tegn hver) som til sammen danner ODBC SQL-setningen for spørringen. Ved hjelp av denne strengen kan du gå utenom Microsoft Query, og sende en ODBC SQL-setning direkte til ODBC for behandling. |
| ODBCSQLStatement/n | En matrise med SQL-segmenter (som kan inneholde opptil n tegn hver) som til sammen danner ODBC SQL-setningen for spørringen. Ved hjelp av dette anmodningselementet kan du lagre en ODBC SQL-setning som flere mindre segmenter. |
| ParameterNames | En matrise med parametere i spørringen. Hvis det ikke finnes parametere, returneres en tom matrise. Dette elementet kan det anmodes om når som helst, selv om parametere er deaktivert for spørringen. |
| Query | Navnet på spørringen. |
| QueryDefinition | En matrise med spørringsdefinisjonssegmenter (som kan inneholde opptil 255 tegn hver) som til sammen danner definisjonen av spørringen (en SQL-setning), slik den er definert i Microsoft Query. Dette elementet kan hentes og lagres for senere spørringer. |
| QueryDefinition/n | En matrise med spørringsdefinisjonssegmenter (som kan inneholde opptil 255 tegn hver) som til sammen danner definisjonen av spørringen (en SQL-setning). |
| Recest | Et løselig anslag av hvor mange rader som kan hentes samtidig. |
| TierType | Ett enkelt siffer som angir datakildetypen: 1 angir en fil som bare kan inneholde én enkelt tabell, 2 angir en fil for en database som inneholder én eller flere tabeller, 3 angir at det ikke er mulig å bla gjennom dataene. Dette anmodningselementet brukes hvis programmet må hente frem dialogboksen Åpne for at en skal kunne bla gjennom dataene på en disk. |
Når du bruker anmodningselementene ovenfor på systemkanelen, returneres informasjonen for spørringsvinduet som sist ble brukt i en DDE-operasjon.
For systemkanalen kan du også anmode om følgende elementer, i tillegg til anmodningselementene ovenfor:
| Anmodningselement | Informasjon som returneres |
|---|---|
| Sources | Alle gjeldende datakildetilkoblinger (bare datakildenavn). |
| Logon | Alle fjerndatabaser du kan koble til (datakildenavnoppføringer fra registeret). |
| Logoff | Alle fjerndatabaser som er koblet til nå (bare datakildenavn). |
| Tables/source/user/database | Alle tabellene for den angitte datakildenavntilkoblingen, brukeren og databasen. Legg merke til at kilden må være et gyldig datakildenavn. |
| Users/source/database | Alle brukerne for den angitte datakildenavntilkoblingen og databasen. Legg merke til at kilden må være et gyldig datakildenavn. |
| Database/source | Alle databaser for den angitte datakildenavntilkoblingen. Legg merke til at kilden må være et gyldig datakildenavn. |
| Username/source/database | Brukernavnet for den angitte datakildenavntilkoblingen og databasen. Legg merke til at kilden må være et gyldig datakildenavn. |
| Topics | Navnene på emnene som er åpne på systemkanalen, sammen med System. |
| Status | Programmets status, som kan være Ready (klart) eller Busy (opptatt). Ready betyr at programmet kan føre en DDE-dialog med Microsoft Query. Busy betyr at Microsoft Query ikke er klart til å delta i en DDE-dialog. |
I dette eksemplet settes verdien som returneres av anmodningselementet NumRows, inn i celle A10 i Microsoft Excel.
ActiveWorksheet.Range("A10").Value = DDERequest(chan, "NumRows")