Udostępnij za pośrednictwem

WebAction.Request

  • Artykuł

Składnia

WebAction.Request(method as text, url as text, optional options as nullable record) as action

Informacje

Tworzy akcję, która po wykonaniu zwróci wyniki wykonania żądania method względem url przy użyciu protokołu HTTP jako wartości binarnej. Opcjonalny parametr rekordu, options, można podać, aby określić dodatkowe właściwości. Rekord może zawierać następujące pola:

  • Query: Programowe dodawanie parametrów zapytania do adresu URL bez konieczności martwienia się o ucieczkę.
  • ApiKeyName: jeśli witryna docelowa ma pojęcie klucza interfejsu API, ten parametr może służyć do określenia nazwy (a nie wartości) parametru klucza, który musi być używany w adresie URL. Rzeczywista wartość klucza jest podana w poświadczeniu.
  • Headers: określenie tej wartości jako rekordu spowoduje podanie dodatkowych nagłówków do żądania HTTP.
  • Timeout: określenie tej wartości jako czasu trwania spowoduje zmianę limitu czasu dla żądania HTTP. Wartość domyślna to 100 sekund.
  • ExcludedFromCacheKey: Określenie tej wartości jako listy spowoduje wykluczenie kluczy nagłówków HTTP z obliczenia danych buforowania.
  • IsRetry: określenie tej wartości logicznej jako true spowoduje zignorowanie dowolnej istniejącej odpowiedzi w pamięci podręcznej podczas pobierania danych.
  • ManualStatusHandling: Określenie tej wartości jako listy uniemożliwi wszelką wbudowaną obsługę żądań HTTP, których odpowiedzi mają jeden z tych kodów stanu.
  • RelativePath: określenie tej wartości jako tekstu powoduje dołączenie jej do podstawowego adresu URL przed wykonaniem żądania.
  • Content: określenie tej wartości spowoduje, że jego zawartość stanie się treścią żądania HTTP.

Należy pamiętać, że ta funkcja jest wyłączona w większości kontekstów. Rozważ użycie Web.Contents lub Web.Headers.

Przykład 1

Wykonaj żądanie GET względem usługi Bing.

Użycie

WebAction.Request(WebMethod.Get, "https://bing.com")

Wyjście

Action