Instance Method インスタンスメソッド

setResourceValue:forKey:error:

Sets the URL’s resource property for a given key to a given value. このURLの持つ、ある与えられたキーに対するリソースプロパティをある与えられた値に設定します。

Declaration 宣言 

- (BOOL)setResourceValue:(id)value 
                  forKey:(NSURLResourceKey)key 
                   error:(NSError * _Nullable *)error;

Parameters パラメータ

value

The value for the resource property defined by key. keyによって識別されるリソースプロパティに対する値。

key

The name of one of the URL’s resource properties. URLの持つリソースプロパティの１つの名前。

error

The error that occurred if the resource value could not be set. リソース値が設定されることができなかった場合に発生したエラー。

Return Value 戻り値

YES if the resource property named key is successfully set to value; otherwise, NO. YES、もしkeyが指名するリソースプロパティがうまくvalueに設定されるならば；そうでなければ、NO。

Discussion 議論

This method synchronously writes the new resource value out to disk. Attempts to set a read-only resource property or to set a resource property that is not supported by the resource are ignored and are not considered errors. このメソッドは、同期的に新しいリソース値をすっかりディスクに書き込みます。読み出し専用リソースプロパティを設定するまたはリソースによってサポートされないリソースプロパティを設定する試みは、無視されます、そしてエラーとみなされません。

If an error occurs, this method returns NO and populates the object pointer referenced by error with additional information. エラーが発生するならば、このメソッドはNOを返します、そしてerrorによって参照されるオブジェクトポインタには追加情報が入れられます。

See Also 参照

Accessing Resource Values リソース値にアクセスする

- resourceValuesForKeys:error:
Returns the resource values for the properties identified by specified array of keys. いくらかのキーからなる指定された配列によって識別されるプロパティそれらに対するリソース値を返します。
- getResourceValue:forKey:error:
Returns the value of the resource property for the specified key. 指定されたキーに対するリソースプロパティの値を返します。
- setResourceValues:error:
Sets the URL’s resource properties for a given set of keys to a given set of values. このURLの持つ、ある与えられた一揃いのキーに対するリソースプロパティそれらをある与えられた一揃いの値に設定します。
- removeAllCachedResourceValues
Removes all cached resource values and temporary resource values from the URL object. 全てのキャッシュされたリソース値と一時リソース値をURLオブジェクトから取り除きます。
- removeCachedResourceValueForKey:
Removes the cached resource value identified by a given key from the URL object. 与えられたキーによって識別されるキャッシュされたリソース値をURLオブジェクトから取り除きます。
- setTemporaryResourceValue:forKey:
Sets a temporary resource value on the URL object. URLオブジェクト上の一時リソース値を設定します。
NSURLResourceKey
Keys that apply to file system URLs. ファイルシステムURLに適用するキーそれら。

Related Documentation 関連文書