API Reference
DnsResponse
Represents a DNS message returned by a resolver. The structure mirrors the response format described in RFC 1035.
Inheritance
- Object
- DnsResponse
Remarks
Instances are produced by ClientX when a query completes.
Usage
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by
- Property AuditEntry.Response
- Method ClientX.DeleteRecordAsync
- Method ClientX.QueryDns
- Method ClientX.QueryDns
- Method ClientX.QueryDns
- Method ClientX.QueryDns
- Method ClientX.QueryDnsSync
- Method ClientX.QueryDnsSync
- Method ClientX.QueryDnsSync
- Method ClientX.Resolve
- Method ClientX.ResolveAsyncEnumerable
- Method ClientX.ResolveFilter
- Method ClientX.ResolveFilter
- Method ClientX.ResolveFromRoot
- Method ClientX.ResolvePattern
- Method ClientX.ResolveStream
- Method ClientX.ResolveSync
- Method ClientX.UpdateRecordAsync
- Property DnsClientException.Response
- Method DnsMultiResolver.QueryAsync
- Method DnsMultiResolver.QueryBatchAsync
- Property DnsQueryException.Response
- Method IDnsMultiResolver.QueryAsync
- Method IDnsMultiResolver.QueryBatchAsync
Accepted by parameters
- Method ClientX.IsTransientResponse
- Constructor DnsClientException.DnsClientException
- Method DnsQueryDiagnostics.HasEnvelopeData
- Method DnsQueryDiagnostics.IsSuspiciousEmptySuccess
- Method DnsQueryDiagnostics.IsTransient
- Constructor DnsQueryException.DnsQueryException
- Method DnsResponseCache.Set
- Method DnsResponseCache.TryGet
- Constructor CacheEntry.CacheEntry
- Method DnsSecValidator.ValidateAgainstRoot
- Method DnsSecValidator.ValidateAgainstRoot
- Method DnsSecValidator.ValidateChain
- Method DnsSecValidator.ValidateChain
Constructors
public DnsResponse() #Methods
AddServerDetails(DnsClientX.Configuration configuration, System.Nullable{DnsClientX.Transport} usedTransport) #Adds the server details to the DNS questions for output purposes.
Parameters
- configuration DnsClientX.Configuration
- Client configuration used when querying.
- usedTransport System.Nullable{DnsClientX.Transport}
- Optional explicit transport override for cases such as UDP-to-TCP fallback.
Inherited Methods
Properties
public DnsResponseCode Status { get; set; } #JsonPropertyName("Status")The status code of the DNS response.
public Int32 RetryCount { get; set; } #JsonIgnoreNumber of retry attempts performed before receiving this response.
public Boolean IsTruncated { get; set; } #JsonPropertyName("TC")Indicates whether the response was truncated. This can occur if the response is larger than the maximum size allowed by the transmission channel. This is typically false for DNS over HTTPS, as most providers support the maximum response size.
public Boolean IsRecursionDesired { get; set; } #JsonPropertyName("RD")Indicates whether recursion was requested in the query. This is typically true for DNS over HTTPS.
public Boolean AuthenticData { get; set; } #JsonPropertyName("AD")Indicates whether the DNS server believes the response is authentic and has been validated by DNSSEC.
public Boolean CheckingDisabled { get; set; } #JsonPropertyName("CD")Indicates whether a security-aware resolver should disable DNSSEC signature validation.
public DnsQuestion[] Questions { get; set; } #JsonPropertyName("Question")The questions that were asked in the DNS query. Some providers do not return the question section in their response. In those cases this property will be null.
public DnsAnswer[] Answers { get; set; } #JsonPropertyName("Answer")The answers provided by the DNS server.
public Object[] TypedAnswers { get; set; } #JsonIgnoreWhen typed parsing is enabled, contains typed representations of Answers.
public String ServerAddress { get; set; } #JsonIgnoreAddress of the DNS server that returned this response.
public DnsResolverEndpoint UsedEndpoint { get; set; } #JsonIgnoreEndpoint used to obtain this response.
public DnsAnswerMinimal[] AnswersMinimal { get; } #JsonIgnoreGets the answers in their minimal form.
public DnsAnswer[] Authorities { get; set; } #JsonPropertyName("Authority")The authority records provided by the DNS server.
public DnsAnswer[] Additional { get; set; } #JsonPropertyName("Additional")Any additional records provided by the DNS server.
public String Error { get; set; } #JsonPropertyName("error")An error message, if there was an issue with the DNS query. This is typically included when the HTTP status code is 400 (Bad Request).
public String Comments { get; set; } #JsonPropertyName("Comment") JsonConverter(typeof(CommentConverter))An extended DNS error code message. For more information, see the Cloudflare documentation.
public ExtendedDnsError[] ExtendedDnsErrors { get; set; } #JsonPropertyName("extended_dns_errors")Extended DNS error information provided by the DNS server.
public ExtendedDnsErrorInfo[] ExtendedDnsErrorInfo { get; } #JsonIgnoreGets the extended DNS error information in a simplified form.
public String EdnsClientSubnet { get; set; } #JsonPropertyName("edns_client_subnet")The client subnet information that the DNS server used to generate the response.
Fields
_answersMinimal #Gets the answers in their minimal form.