REST.Backend.KinveyApi.TKinveyApi.UploadFile
Delphi
procedure UploadFile(const AFileName: string; AContentType: string; APublic: Boolean; const AUserFields: TJSONObject; out ANewFile: TFile); overload;
procedure UploadFile(const AFileName: string; const AStream: TStream; AContentType: string; APublic: Boolean; const AUserFields: TJSONObject; out ANewFile: TFile); overload;
C++
void __fastcall UploadFile(const System::UnicodeString AFileName, System::UnicodeString AContentType, bool APublic, System::Json::TJSONObject* const AUserFields, /* out */ TFile &ANewFile)/* overload */;
void __fastcall UploadFile(const System::UnicodeString AFileName, System::Classes::TStream* const AStream, System::UnicodeString AContentType, bool APublic, System::Json::TJSONObject* const AUserFields, /* out */ TFile &ANewFile)/* overload */;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | REST.Backend.KinveyApi.pas REST.Backend.KinveyApi.hpp |
REST.Backend.KinveyApi | TKinveyApi |
説明
Kinvey にファイルをアップロードします。
UploadFile メソッドは、次のパラメータを受け取ります。
| パラメータ | 説明 |
|---|---|
AFileName
|
ファイル名を表す文字列です。 |
AContentType
|
ファイルの内容の種類を示す文字列です。 |
APublic
|
デフォルトでは、Kinvey にアップロードされたファイルは非公開です。このパラメータを True に設定すると、公開ファイルを作成できます。ファイルを公開ファイルとしてアップロードすると、このファイルへのダウンロード リンクは、ファイルが削除されるまでまたは非公開に設定されるまで有効期限が切れない通常の未署名 URL になります。
|
AUserFields
|
TRESTRequest に含まれている TJSONObject です。 |
ANewFile
|
ファイルに関する情報を格納するための TFile 型の出力パラメータです。 |
AStream
|
ファイルのアップロードに使用する TStream です。 メモ： この引数は 2 番目のオーバーロード メソッドにのみ使用されます。 |
UploadFile の第 1 のオーバーロード メソッドでは、上記の表の上から 5 つのパラメータを受け取り、AFileName の TFileStream を作成し、その TFileStream を AStream パラメータとして追加して第 2 のオーバーロード メソッドを呼び出します。
Kinvey にファイルをアップロードするには、次の 2 つのステップが必要になります。
- UploadFile は、ファイルのアップロード先となるアップロード URL を取得するため、Kinvey に POST 要求を送信します。この最初のステップでは、ファイルの内容をアップロードせず、アップロード URL を取得するだけです。
- その次に、UploadFile は Kinvey に PUT 要求を送信して、アップロード URL を指定しファイルの内容を送信します。
- メモ： Kinvey では、Google クラウド ストレージを使用してファイルを格納します。